Исходный код вики Google Sheets (Private)

Редактировал(а) Ирина Сафонова 21.03.2024, 22:50
Скрыть последних авторов
Ирина Сафонова 1.1 1 {{box cssClass="floatinginfobox" title="**Содержание**"}}
2 {{toc/}}
3 {{/box}}
4
5 (% data-xwiki-non-generated-content="java.util.List" %)
6 (((
7 = Что такое Google Sheets (Private)? =
8 )))
9
10 **Google Sheets (Private) **— онлайн-сервис от Google, предназначенный для создания и редактирования электронных таблиц. Сервис позволяет пользователям создавать таблицы, вносить в них данные, проводить вычисления, анализировать информацию и совместно работать над таблицами с другими пользователями в режиме реального времени. Также это таблицы, в которых владелец предоставляет права доступа определенным пользователям.
11
12 {{info}}
13 Коннектор к таблицам Google построен на базе** SQLite** и поддерживает все команды **SQLite**.
14 {{/info}}
15
16 = Этапы подключения Cloud BI к Google Sheets (Private) =
17
18 ----
19
20 (% class="wikigeneratedid" %)
21 Подключение состоит из шести последовательных шагов:
22
Ирина Сафонова 3.1 23 1. [[Создание и базовая настройка проекта Google>>https://wiki.dfcloud.ru/bin/view/Big%20Data/Cloud%20BI_new/%D0%90%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5/%D0%98%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F%20%D1%81%20%D0%91%D0%94/%D0%A1%D0%BF%D0%B8%D1%81%D0%BE%D0%BA%20%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B9%20%D1%81%20%D0%91%D0%94/Google%20Sheets%20(Private)/#H4284304331.42143E43743443043D43843543843143043743E43243044F43D43044144244043E43943A43043F44043E43543A442430A0Google]].
Ирина Сафонова 4.1 24 1. [[Создание и настройка сервисного аккаунта Google>>https://wiki.dfcloud.ru/bin/view/Big%20Data/Cloud%20BI_new/%D0%90%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5/%D0%98%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F%20%D1%81%20%D0%91%D0%94/%D0%A1%D0%BF%D0%B8%D1%81%D0%BE%D0%BA%20%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B9%20%D1%81%20%D0%91%D0%94/Google%20Sheets%20(Private)/#H4284304332.42143E43743443043D43843543843D43044144244043E43943A43044143544043243844143D43E43343E43043A43A43044343D442430Google]].
Ирина Сафонова 5.1 25 1. [[Делегирование полномочий на уровне домена>>https://wiki.dfcloud.ru/bin/view/Big%20Data/Cloud%20BI_new/%D0%90%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5/%D0%98%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F%20%D1%81%20%D0%91%D0%94/%D0%A1%D0%BF%D0%B8%D1%81%D0%BE%D0%BA%20%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B9%20%D1%81%20%D0%91%D0%94/Google%20Sheets%20(Private)/#H4284304333.41443543B43543343844043E43243043D43843543F43E43B43D43E43C43E44743843943D43044344043E43243D43543443E43C43543D430]].
Ирина Сафонова 6.1 26 1. [[Включение API>>https://wiki.dfcloud.ru/bin/view/Big%20Data/Cloud%20BI_new/%D0%90%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5/%D0%98%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F%20%D1%81%20%D0%91%D0%94/%D0%A1%D0%BF%D0%B8%D1%81%D0%BE%D0%BA%20%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B9%20%D1%81%20%D0%91%D0%94/Google%20Sheets%20(Private)/#H4284304334.41243A43B44E44743543D438435API]].
Ирина Сафонова 7.1 27 1. [[Настройка подключения к БД>>https://wiki.dfcloud.ru/bin/view/Big%20Data/Cloud%20BI_new/%D0%90%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5/%D0%98%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F%20%D1%81%20%D0%91%D0%94/%D0%A1%D0%BF%D0%B8%D1%81%D0%BE%D0%BA%20%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B9%20%D1%81%20%D0%91%D0%94/Google%20Sheets%20(Private)/#H4284304335.41D43044144244043E43943A43043F43E43443A43B44E44743543D43844F43A411414]].
Ирина Сафонова 8.1 28 1. [[Добавление датасета>>https://wiki.dfcloud.ru/bin/view/Big%20Data/Cloud%20BI_new/%D0%90%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5/%D0%98%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F%20%D1%81%20%D0%91%D0%94/%D0%A1%D0%BF%D0%B8%D1%81%D0%BE%D0%BA%20%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B9%20%D1%81%20%D0%91%D0%94/Google%20Sheets%20(Private)/#H4284304336.41443E43143043243B43543D438435434430442430441435442430]].
Ирина Сафонова 1.1 29
30 == Шаг 1. Создание и базовая настройка проекта Google ==
31
32 **Проект Google** — функционал, использующийся для организации ресурсов Google. Проект состоит из:
33
34 * пользователей,
35 * набора, аутентификации и мониторинга API.
36
37 Пример функционала — сегменты и объекты **Cloud Storage**, разрешения пользователя на доступ к сегментам и объектам находятся в проекте.
38
39 ~1. Выберите проект Google в [[**Google Cloud**>>https://console.cloud.google.com/]].
40
41 1.1 Убедитесь, что ваш аккаунт Google связан с необходимой таблицей Google.
42
43 1.2. Выберите страну и ознакомьтесь с условиями использования **Google Cloud.**
44
45 **~ **1.3. Выберите необходимый проект Google.
46
47 2. На вкладке **Service Accounts** нажмите кнопку **Create Project**.
48
49 3. В открывшемся окне введите обязательные параметры проекта:
50
51 * **Project name**. Имя проекта — идентификатор проекта.
52 * **Organization**. Поле отображается, если учетная запись Google, под которой вы вошли в систему, принадлежит организации. По умолчанию отображается домен организации.
53 * **Location**. Выберите из списка.
54
Ирина Сафонова 9.1 55 4. Перейдите к [[созданию и настройке сервисного аккаунта Google>>https://wiki.dfcloud.ru/bin/view/Big%20Data/Cloud%20BI_new/%D0%90%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5/%D0%98%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F%20%D1%81%20%D0%91%D0%94/%D0%A1%D0%BF%D0%B8%D1%81%D0%BE%D0%BA%20%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B9%20%D1%81%20%D0%91%D0%94/Google%20Sheets%20(Private)/#H4284304332.42143E43743443043D43843543843D43044144244043E43943A43044143544043243844143D43E43343E43043A43A43044343D442430Google]].
Ирина Сафонова 1.1 56
57 == Шаг 2. Создание и настройка сервисного аккаунта Google ==
58
Ирина Сафонова 12.1 59 **Сервисные аккаунты** — аккаунты Google для доступа приложений к менеджеру рекламы через API. Аккаунты не требуют персональной авторизации. Вместо этого используется файл ключа, доступ к которому есть только у вашего приложения. Сначала создайте [[сервисный аккаунт>>https://wiki.dfcloud.ru/bin/view/Big%20Data/Cloud%20BI_new/%D0%90%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5/%D0%98%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F%20%D1%81%20%D0%91%D0%94/%D0%A1%D0%BF%D0%B8%D1%81%D0%BE%D0%BA%20%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B9%20%D1%81%20%D0%91%D0%94/Google%20Sheets%20(Private)/#H41F43E4344484304332.1.42143E43743443043D43843544143544043243844143D43E43343E43043A43A43044343D442430A0Google]], затем — [[ключи JSON>>https://wiki.dfcloud.ru/bin/view/Big%20Data/Cloud%20BI_new/%D0%90%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5/%D0%98%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F%20%D1%81%20%D0%91%D0%94/%D0%A1%D0%BF%D0%B8%D1%81%D0%BE%D0%BA%20%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B9%20%D1%81%20%D0%91%D0%94/Google%20Sheets%20(Private)/#H41F43E4344484304332.2.42143E43743443043D43843543A43B44E447430A0JSON]].
Ирина Сафонова 1.1 60
61 === Подшаг 2.1. Создание сервисного аккаунта Google ===
62
63 ~1. Нажмите кнопку **+ Create Service Account**.
64
65 2. В открывшемся окне введите параметры аккаунта:
66
67 * **Service account name**. Введите удобное для запоминания имя аккаунта.
68 * **Service account description**. Введите описание сервисного аккаунта.
69
70 3. Нажмите кнопку **Create and Continue**.
71
72 4. Выберите значение в поле **Select a role**:
73
74 * **Editor**: доступ к редактированию всех ресурсов учетной записи службы.
75 * **Owner**: полный доступ ко всем ресурсам сервисного аккаунта.
76 * **Viewer**: просмотр доступа ко всем ресурсам сервисного аккаунта.
77
78 {{warning}}
79 Если выбран вариант //Просмотр //— вы не сможете выполнить загрузку файла CSV.
80 {{/warning}}
81
82 {{info}}
83 Доступно множественное создание ролей по кнопке **Add Another Role**. Также доступно удаление ролей.
84 {{/info}}
85
86 (% class="box infomessage" %)
87 (((
88 **Grant users access to this service account** можно пропустить.
89 )))
90
91 5. Нажмите кнопку **Done**.
92
93 === Подшаг 2.2. Создание ключа JSON ===
94
95 ~1. В столбце **Actions** таблицы проектов нажмите троеточие и выберите **Manage Keys**.
96
97 2. В открывшейся форме нажмите на кнопку **Add Key** и выберите **Create new key**.
98
99 3. В открывшейся форме выберите тип ключа //JSON //и нажмите кнопку **Create**.
100
101 4. Сохраните файл с ключом //JSON//.
102
103 (% class="box successmessage" %)
104 (((
105 В результате действий **Шага 2**:
106
107 * Создан проект и сервисный аккаунт Google.
108 * Добавлен ключ JSON.
109 )))
110
111 == Шаг 3. Делегирование полномочий на уровне домена ==
112
113 Делегирование полномочий на уровне домена означает, что мы автоматически авторизуем сервисный аккаунт для доступа к пользовательским данным в домене Google Workspace.
114
Ирина Сафонова 13.1 115 ~1. Откройте новую вкладку в браузере и перейдите по [[ссылке>>https://admin.google.com/ac/accountchooser?continue=https://admin.google.com/ac/owl/domainwidedelegation]].
Ирина Сафонова 1.1 116
117 2. В поле **Client ID** вставьте **Unique ID** из сервисного аккаунта.
118
119 3. Заполните группу полей **OAuth scopes**, чтобы предоставить доступ к сервисам Google:
120
121 * https:~/~/www.googleapis.com/auth/spreadsheets.readonly
122 * https:~/~/www.googleapis.com/auth/drive.readonly
123 * https:~/~/spreadsheets.google.com/feeds
124
125 4. Нажмите кнопку **Authorize**.
126
127 == Шаг 4. Включение API ==
128
129 ~1. Проверьте, что вы в нужной учетной записи Google.
130
131 2. Перейдите по ссылке** [[Google Sheets API>>https://console.cloud.google.com/apis/api/sheets.googleapis.com/overview?project=grand-practice-409214]]** в консоли **Google Cloud Platform **и нажмите кнопку **Enable**.
132
133 3. Перейдите по ссылке** [[Google Drive API>>https://console.cloud.google.com/apis/api/drive.googleapis.com/overview?project=grand-practice-409214]]** в консоли **Google Cloud Platform **и нажмите кнопку **Enable**.
134
135 {{success}}
136 Настройка Google завершена.
137 {{/success}}
138
139 == Шаг 5. Настройка подключения к БД ==
140
141 ~1. В разделе **Настройки** перейдите в **Данные, **затем нажмите кнопку **Подключить Google таблицы**.
142
143 2. В открывшейся форме укажите:
144
145 * **отображаемое имя таблицы**
146 * **допустимый тип Google таблиц.** Выберите //Public and privately shared sheets//.
147
148 Дальнейшая настройка зависит от значения в поле HOW DO YOU WANT TO ENTER SERVICE ACCOUNT CREDENTIALS?. Если выбрали //Загрузить //JSON-файл// //— перейдите к [[**Вариант 1: Загрузить JSON-файл**>>https://wiki.dfcloud.ru/bin/view/Big%20Data/%D0%A1%D0%B5%D1%80%D0%B2%D0%B8%D1%81%20Cloud%20BI/2.%20%D0%98%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BA%D1%86%D0%B8%D1%8F/02.%20%D0%A0%D1%83%D0%BA%D0%BE%D0%B2%D0%BE%D0%B4%D1%81%D1%82%D0%B2%D0%BE%20%D0%B0%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B0%D1%82%D0%BE%D1%80%D0%B0/A.%20%D0%A1%D0%BE%D0%B5%D0%B4%D0%B8%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5%20%D1%81%20%D0%B1%D0%B0%D0%B7%D0%B0%D0%BC%D0%B8%20%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85/F21.%20Google%20Sheets%20%28Private%29/#H41243044043843043D4421:41743043344044343743844244CJSON-44443043943B]]. Если выбрали //Скопировать и вставить JSON-данные// перейдите к [[**Вариант 2: Скопировать и вставить JSON-данные**>>https://wiki.dfcloud.ru/bin/view/Big%20Data/%D0%A1%D0%B5%D1%80%D0%B2%D0%B8%D1%81%20Cloud%20BI/2.%20%D0%98%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BA%D1%86%D0%B8%D1%8F/02.%20%D0%A0%D1%83%D0%BA%D0%BE%D0%B2%D0%BE%D0%B4%D1%81%D1%82%D0%B2%D0%BE%20%D0%B0%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B0%D1%82%D0%BE%D1%80%D0%B0/A.%20%D0%A1%D0%BE%D0%B5%D0%B4%D0%B8%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5%20%D1%81%20%D0%B1%D0%B0%D0%B7%D0%B0%D0%BC%D0%B8%20%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85/F21.%20Google%20Sheets%20%28Private%29/#H41243044043843043D4422:A042143A43E43F43844043E43243044244C43843244144243043243844244CA0JSON-43443043D43D44B435]].
149
150 === Вариант 1: Загрузить JSON-файл ===
151
152 ~1. В поле **Загрузить учетные данные** выберите заранее загруженный JSON-файл. В результате файл появится в списке.
153
154 2. При необходимости удалите загруженный в **Cloud BI** файл.
155
156 === Вариант 2: Скопировать и вставить JSON-данные ===
157
158 ~1. В поле **Сервисный аккаунт** вставьте код JSON.
159
Ирина Сафонова 13.1 160 2. Подключите Google таблицы для БД.
Ирина Сафонова 1.1 161
Ирина Сафонова 13.1 162 2.1. Откройте новую вкладку и перейдите в свою личную таблицу Google. Скопируйте ссылку на таблицу с ограниченным доступом в буфер обмена.
Ирина Сафонова 1.1 163
Ирина Сафонова 13.1 164 2.2. Подключите Google таблицу. Введите данные:
Ирина Сафонова 1.1 165
166 * **Название листа**.
167 * **Ссылку на таблицу Google**.
168
169 {{info}}
170 Дополнительные таблицы добавляются по кнопке **+Добавить лист**.
171 {{/info}}
172
Ирина Сафонова 13.1 173 3. Нажмите кнопку **Подключить.**
Ирина Сафонова 1.1 174
Ирина Сафонова 13.1 175 4. При необходимости настройте дополнительные параметры подключения к БД.
Ирина Сафонова 1.1 176
Ирина Сафонова 13.1 177 5. Чтобы завершить подключение, нажмите кнопку **Готово**.
Ирина Сафонова 1.1 178
179 {{success}}
180 В результате вы подключились к БД.
181 {{/success}}
182
183 == Шаг 6. Добавление датасета ==
184
185 **Датасет** или// //набор данных — механизм хранения информации, который предоставляет быстрый доступ к большим объемам данных. Датасеты создаются из таблиц базы данных или SQL-запросов.
186
187 ~1. Нажмите кнопку **Датасет **в реестре.
188
189 2. В открывшемся окне выберете:
190
Ирина Сафонова 14.1 191 * **Базу данных**. Выберите имя базы данных, определенное в пункте 2.1 [[шага 5>>https://wiki.dfcloud.ru/bin/view/Big%20Data/Cloud%20BI_new/%D0%90%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5/%D0%98%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F%20%D1%81%20%D0%91%D0%94/%D0%A1%D0%BF%D0%B8%D1%81%D0%BE%D0%BA%20%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B9%20%D1%81%20%D0%91%D0%94/Google%20Sheets%20(Private)/#H4284304335.41D43044144244043E43943A43043F43E43443A43B44E44743543D43844F43A411414]].
Ирина Сафонова 1.1 192 * **Схему**.
193 * **Таблицу БД**.
194
195 3. Нажмите кнопку **ADD DATASET AND CREATE CHART**.
196
197 {{success}}
198 После выполнения настроек можно создавать графики с данными таблиц Google.
199 {{/success}}
200
Ирина Сафонова 18.1 201 = См. также =
Ирина Сафонова 1.1 202
203 ----
204
Ирина Сафонова 15.1 205 * [[Подключение к БД>>https://wiki.dfcloud.ru/bin/view/Big%20Data/Cloud%20BI_new/%D0%90%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5/%D0%98%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F%20%D1%81%20%D0%91%D0%94/%D0%9F%D0%BE%D0%B4%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D0%B5%20%D0%BA%20%D0%91%D0%94%20%D0%B2%20%D0%B8%D0%BD%D1%82%D0%B5%D1%80%D1%84%D0%B5%D0%B9%D1%81%D0%B5%20Cloud%20BI/]]
Ирина Сафонова 17.1 206 * [[Создание и настройка графиков>>https://wiki.dfcloud.ru/bin/view/Big%20Data/Cloud%20BI_new/%D0%93%D1%80%D0%B0%D1%84%D0%B8%D0%BA%D0%B8/]]
Ирина Сафонова 1.1 207 * (((
Ирина Сафонова 16.1 208 [[Создание и настройка датасетов>>https://wiki.dfcloud.ru/bin/view/Big%20Data/Cloud%20BI_new/%D0%94%D0%B0%D1%82%D0%B0%D1%81%D0%B5%D1%82%D1%8B/]]
Ирина Сафонова 1.1 209 )))