Исходный код вики F21. Google Sheets (Private)
Версия 24.1 от Ирина Сафонова на 25.12.2023, 23:37
Последние авторы
author | version | line-number | content |
---|---|---|---|
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 | ~1. В разделе **Настройки** перейдите в **Данные, **затем нажмите кнопку **Подключить Google таблицы**. | ||
150 | |||
151 | 2. В открывшейся форме: | ||
152 | |||
153 | 2.1. Укажите следующие данные: | ||
154 | |||
155 | * отображаемое имя | ||
156 | * допустимый тип Google таблиц — //Public and privately shared sheets//. | ||
157 | * HOW DO YOU WANT TO ENTER SERVICE ACCOUNT CREDENTIALS? | ||
158 | |||
159 | 2.2. | ||
160 | |||
161 | |||
162 |