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

Версия 32.1 от Ирина Сафонова на 26.12.2023, 12:55
Последние авторы
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 (% class="wikigeneratedid" %)
22 Создание и базовая настройка проекта Google.
23
24 (% class="wikigeneratedid" %)
25 Создание и настройка сервисного аккаунта Google.
26
27 (% class="wikigeneratedid" %)
28 Делегирование полномочий на уровне домена.
29
30 = Шаг 1. Создание и базовая настройка проекта Google =
31
32 ----
33
34 **Проект Google** — функционал, использующийся для организации ресурсов Google. Проект состоит из:
35
36 * пользователей
37 * набора, аутентификации и мониторинга API
38
39 Пример функционала — сегменты и объекты Cloud Storage, разрешения пользователя на доступ к сегментам и объектам находятся в проекте.
40
41 ~1. Выберите проект Google в [[**Google Cloud**>>https://console.cloud.google.com/]].
42
43 1.1 Убедитесь, что ваш аккаунт Google связан с необходимой таблицей Google.
44
45 1.2. Выберите страну и ознакомьтесь с условиями использования **Google Cloud.**
46
47 **~ **1.3. Выберите необходимый проект Google.
48
49 2. На вкладке **Service Accounts** нажмите кнопку **Create Project**.
50
51 3. В открывшемся окне введите обязательные параметры проекта:
52
53 * **Project name**. Имя проекта — идентификатор проекта.
54 * **Organization**. Поле отображается, если учетная запись Google, под которой вы вошли в систему, принадлежит организации. По умолчанию отображается домен организации.
55 * **Location**. Выберите из списка.
56
57 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]].
58
59 = Шаг 2. Создание и настройка сервисного аккаунта Google =
60
61 ----
62
63 **Сервисные аккаунты** — аккаунты 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]].
64
65 == Подшаг 2.1. Создание сервисного аккаунта Google ==
66
67 ~1. Нажмите кнопку **+ Create Service Account**.
68
69 2. В открывшемся окне введите параметры аккаунта:
70
71 * **Service account name**. Введите удобное для запоминания имя аккаунта.
72 * **Service account description**. Введите описание сервисного аккаунта.
73
74 3. Нажмите кнопку **Create and Continue**.
75
76 4. Выберите значение в поле **Select a role**:
77
78 * **Editor**: доступ к редактированию всех ресурсов учетной записи службы.
79 * **Owner**: полный доступ ко всем ресурсам сервисного аккаунта.
80 * **Viewer**: просмотр доступа ко всем ресурсам сервисного аккаунта.
81
82 {{warning}}
83 Если выбран вариант //Просмотр //— вы не сможете выполнить загрузку файла CSV.
84 {{/warning}}
85
86 {{info}}
87 Доступно множественное создание ролей по кнопке **Add Another Role**. Также доступно удаление ролей.
88 {{/info}}
89
90 (% class="box infomessage" %)
91 (((
92 **Grant users access to this service account** можно пропустить.
93 )))
94
95 5. Нажмите кнопку **Done**.
96
97 == Подшаг 2.2. Создание ключа JSON ==
98
99 ~1. В столбце **Actions** таблицы проектов нажмите троеточие и выберите **Manage Keys**.
100
101 2. В открывшейся форме нажмите на кнопку **Add Key** и выберите **Create new key**.
102
103 3. В открывшейся форме выберите тип ключа //JSON //и нажмите кнопку **Create**.
104
105 4. Сохраните файл с ключом //JSON//.
106
107 (% class="box successmessage" %)
108 (((
109 В результате действий **Шага 1**:
110
111 * Создан проект и сервисный аккаунт Google.
112 * Добавлен ключ JSON.
113 )))
114
115 = Шаг 3. Делегирование полномочий на уровне домена =
116
117 ----
118
119 Делегирование полномочий на уровне домена означает, что мы автоматически авторизуем сервисный аккаунт для доступа к пользовательским данным в домене Google Workspace.
120
121 ~1. Откройте новую вкладку в браузере и перейдите по этой [[ссылке>>https://admin.google.com/ac/accountchooser?continue=https://admin.google.com/ac/owl/domainwidedelegation]].
122
123 2. В поле **Client ID** вставьте **Unique ID** из сервисного аккаунта.
124
125 3. Заполните группу полей **OAuth scopes**, чтобы предоставить доступ к этим сервисам Google:
126
127 * https:~/~/www.googleapis.com/auth/spreadsheets.readonly
128 * https:~/~/www.googleapis.com/auth/drive.readonly
129 * https:~/~/spreadsheets.google.com/feeds
130
131 4. Нажмите кнопку **Authorize**.
132
133 = Шаг 4. Включение API =
134
135 ----
136
137 ~1. Проверьте, что вы в нужной учетной записи Google.
138
139 2. Перейдите по ссылке** [[Google Sheets API>>https://console.cloud.google.com/apis/api/sheets.googleapis.com/overview?project=grand-practice-409214]]** в консоли **Google Cloud Platform **и нажмите кнопку **Enable**.
140
141 3. Перейдите по ссылке** [[Google Drive API>>https://console.cloud.google.com/apis/api/drive.googleapis.com/overview?project=grand-practice-409214]]** в консоли **Google Cloud Platform **и нажмите кнопку **Enable**.
142
143 {{success}}
144 Настройка Google полностью завершена.
145 {{/success}}
146
147 = Шаг 5. Настройка подключения к БД =
148
149 ----
150
151 ~1. В разделе **Настройки** перейдите в **Данные, **затем нажмите кнопку **Подключить Google таблицы**.
152
153 2. В открывшейся форме:
154
155 2.1. Укажите следующие данные:
156
157 * отображаемое имя
158 * допустимый тип Google таблиц. Выберите //Public and privately shared sheets//.
159
160 Дальнейшая настройка зависит от значения в поле 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]].
161
162 == Вариант 1: Загрузить JSON-файл ==
163
164 ~1. В поле **Загрузить учетные данные** выберите заранее загруженный JSON-файл.
165
166 В результате файл появится в списке.
167
168 2. При необходимости удалите загруженный в **Cloud BI** файл.
169
170 == Вариант 2: Скопировать и вставить JSON-данные ==
171
172 ~1. В поле **Сервисный аккаунт** вставьте код JSON.
173
174 [[image:Скопировать и вставить JSON-данные.PNG||data-xwiki-image-style-border="true" height="897" width="743"]]
175
176 3. Подключите Google таблицы для БД.
177
178 3.1. Откройте новую вкладку и перейдите в свою личную таблицу Google. Скопируйте ссылку на таблицу с ограниченным доступом в буфер обмена.
179
180 3.2. Подключите Google таблицу. Введите данные:
181
182 * Название листа
183 * Ссылку на таблицу Google.
184
185 {{info}}
186 Дополнительные таблицы добавляются по кнопке **+Добавить лист**.
187 {{/info}}
188
189 4. Нажмите кнопку **Подключить.**
190
191 [[image:Подключение к таблицам Гугл.PNG||data-xwiki-image-style-border="true"]]
192
193
194