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

Версия 38.1 от Ирина Сафонова на 26.12.2023, 13:14
Последние авторы
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 ----
11
12 Раздел описывает, как подключиться к закрытым таблицам Google (Google Sheets (Private).
13
14 {{info}}
15 Коннектор к таблицам Google построен на базе** SQLite** и поддерживает все команды **SQLite**.
16 {{/info}}
17
18 (% class="wikigeneratedid" %)
19 Подключение состоит из шести последовательных шагов:
20
21 1. [[Создание и базовая настройка проекта Google>>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/#H4284304331.42143E43743443043D43843543843143043743E43243044F43D43044144244043E43943A43043F44043E43543A442430A0Google]].
22 1. [[Создание и настройка сервисного аккаунта Google>>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/#H4284304332.42143E43743443043D43843543843D43044144244043E43943A43044143544043243844143D43E43343E43043A43A43044343D442430Google]].
23 1. [[Делегирование полномочий на уровне домена>>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/#H4284304333.41443543B43543343844043E43243043D43843543F43E43B43D43E43C43E44743843943D43044344043E43243D43543443E43C43543D430]].
24 1. [[Включение API>>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/#H4284304334.41243A43B44E44743543D438435API]].
25 1. [[Настройка подключения к БД>>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/#H4284304335.41D43044144244043E43943A43043F43E43443A43B44E44743543D43844F43A411414]].
26 1. [[Добавление датасета>>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/#H4284304336.41443E43143043243B43543D438435434430442430441435442430]].
27
28 = Шаг 1. Создание и базовая настройка проекта Google =
29
30 ----
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
55 4. Перейдите к [[созданию и настройке сервисного аккаунта Google>>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/#H4284304332.42143E43743443043944243543843D43044144244043E43944243544143544043243844143D44B43943043A43A43044343D442Google]].
56
57 = Шаг 2. Создание и настройка сервисного аккаунта Google =
58
59 ----
60
61 **Сервисные аккаунты** — аккаунты Google для доступа приложений к менеджеру рекламы через API. Аккаунты не требуют персональной авторизации. Вместо этого используется файл ключа, доступ к которому есть только у вашего приложения. Сначала создайте [[сервисный аккаунт>>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/#H41F43E4344484304332.1.42143E43743443043D43843544143544043243844143D43E43343E43043A43A43044343D442430A0Google]], затем — [[ключи 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/#H41F43E4344484304332.2.42143E43743443043D43843543A43B44E447430A0JSON]].
62
63 == Подшаг 2.1. Создание сервисного аккаунта Google ==
64
65 ~1. Нажмите кнопку **+ Create Service Account**.
66
67 2. В открывшемся окне введите параметры аккаунта:
68
69 * **Service account name**. Введите удобное для запоминания имя аккаунта.
70 * **Service account description**. Введите описание сервисного аккаунта.
71
72 3. Нажмите кнопку **Create and Continue**.
73
74 4. Выберите значение в поле **Select a role**:
75
76 * **Editor**: доступ к редактированию всех ресурсов учетной записи службы.
77 * **Owner**: полный доступ ко всем ресурсам сервисного аккаунта.
78 * **Viewer**: просмотр доступа ко всем ресурсам сервисного аккаунта.
79
80 {{warning}}
81 Если выбран вариант //Просмотр //— вы не сможете выполнить загрузку файла CSV.
82 {{/warning}}
83
84 {{info}}
85 Доступно множественное создание ролей по кнопке **Add Another Role**. Также доступно удаление ролей.
86 {{/info}}
87
88 (% class="box infomessage" %)
89 (((
90 **Grant users access to this service account** можно пропустить.
91 )))
92
93 5. Нажмите кнопку **Done**.
94
95 == Подшаг 2.2. Создание ключа JSON ==
96
97 ~1. В столбце **Actions** таблицы проектов нажмите троеточие и выберите **Manage Keys**.
98
99 2. В открывшейся форме нажмите на кнопку **Add Key** и выберите **Create new key**.
100
101 3. В открывшейся форме выберите тип ключа //JSON //и нажмите кнопку **Create**.
102
103 4. Сохраните файл с ключом //JSON//.
104
105 (% class="box successmessage" %)
106 (((
107 В результате действий **Шага 1**:
108
109 * Создан проект и сервисный аккаунт Google.
110 * Добавлен ключ JSON.
111 )))
112
113 = Шаг 3. Делегирование полномочий на уровне домена =
114
115 ----
116
117 Делегирование полномочий на уровне домена означает, что мы автоматически авторизуем сервисный аккаунт для доступа к пользовательским данным в домене Google Workspace.
118
119 ~1. Откройте новую вкладку в браузере и перейдите по этой [[ссылке>>https://admin.google.com/ac/accountchooser?continue=https://admin.google.com/ac/owl/domainwidedelegation]].
120
121 2. В поле **Client ID** вставьте **Unique ID** из сервисного аккаунта.
122
123 3. Заполните группу полей **OAuth scopes**, чтобы предоставить доступ к этим сервисам Google:
124
125 * https:~/~/www.googleapis.com/auth/spreadsheets.readonly
126 * https:~/~/www.googleapis.com/auth/drive.readonly
127 * https:~/~/spreadsheets.google.com/feeds
128
129 4. Нажмите кнопку **Authorize**.
130
131 = Шаг 4. Включение API =
132
133 ----
134
135 ~1. Проверьте, что вы в нужной учетной записи Google.
136
137 2. Перейдите по ссылке** [[Google Sheets API>>https://console.cloud.google.com/apis/api/sheets.googleapis.com/overview?project=grand-practice-409214]]** в консоли **Google Cloud Platform **и нажмите кнопку **Enable**.
138
139 3. Перейдите по ссылке** [[Google Drive API>>https://console.cloud.google.com/apis/api/drive.googleapis.com/overview?project=grand-practice-409214]]** в консоли **Google Cloud Platform **и нажмите кнопку **Enable**.
140
141 {{success}}
142 Настройка Google полностью завершена.
143 {{/success}}
144
145 = Шаг 5. Настройка подключения к БД =
146
147 ----
148
149 ~1. В разделе **Настройки** перейдите в **Данные, **затем нажмите кнопку **Подключить Google таблицы**.
150
151 2. В открывшейся форме:
152
153 2.1. Укажите следующие данные:
154
155 * отображаемое имя
156 * допустимый тип Google таблиц. Выберите //Public and privately shared sheets//.
157
158 Дальнейшая настройка зависит от значения в поле 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]].
159
160 == Вариант 1: Загрузить JSON-файл ==
161
162 ~1. В поле **Загрузить учетные данные** выберите заранее загруженный JSON-файл.
163
164 В результате файл появится в списке.
165
166 2. При необходимости удалите загруженный в **Cloud BI** файл.
167
168 == Вариант 2: Скопировать и вставить JSON-данные ==
169
170 ~1. В поле **Сервисный аккаунт** вставьте код JSON.
171
172 [[image:Скопировать и вставить JSON-данные.PNG||data-xwiki-image-style-border="true" height="897" width="743"]]
173
174 3. Подключите Google таблицы для БД.
175
176 3.1. Откройте новую вкладку и перейдите в свою личную таблицу Google. Скопируйте ссылку на таблицу с ограниченным доступом в буфер обмена.
177
178 3.2. Подключите Google таблицу. Введите данные:
179
180 * Название листа
181 * Ссылку на таблицу Google.
182
183 {{info}}
184 Дополнительные таблицы добавляются по кнопке **+Добавить лист**.
185 {{/info}}
186
187 4. Нажмите кнопку **Подключить.**
188
189 [[image:Подключение к таблицам Гугл.PNG||data-xwiki-image-style-border="true" height="1268" width="741"]]
190
191 5. При необходимости настройте дополнительные параметры подключения к БД.
192
193 6. Чтобы завершить подключение, нажмите кнопку **Готово**.
194
195 = Шаг 6. Добавление датасета =
196
197 ----
198
199 **Датасет** или// //набор данных — механизм хранения информации, который предоставляет быстрый доступ к большим объемам данных. Датасеты создаются из таблиц базы данных или SQL-запросов.
200
201 ~1. Нажмите кнопку **Датасет **в реестре.
202
203 2. В открывшемся окне выберете:
204
205 * **Базу данных**. Выберите имя базы данных, которое вы определили на [[**шаге 5**>>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/#H4284304335.41D43044144244043E43943A43043F43E43443A43B44E44743543D43844F43A411414]] в пункте 2.1.
206 * **Схему**.
207 * **Таблицу БД**.
208
209 3. Нажмите кнопку **ADD DATASET AND CREATE CHART**.
210
211 {{success}}
212 После выполнения настроек вы можете создавать графики с использованием данных Google Sheet.
213 {{/success}}
214
215 **[[В начало>>path:/bin/view/Big%20Data/%D0%A1%D0%B5%D1%80%D0%B2%D0%B8%D1%81%20Cloud%20BI/]] **🡱
216 **К следующему разделу **🡲
217 **К предыдущему разделу 🡰**