Исходный код вики F21. Google Sheets (Private)
Версия 34.1 от Ирина Сафонова на 26.12.2023, 13:03
Скрыть последних авторов
| author | version | line-number | content |
|---|---|---|---|
 |
1.2 | 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 | |||
| |
19.1 | 12 | Раздел описывает, как подключиться к закрытым таблицам Google (Google Sheets (Private). |
| |
1.2 | 13 | |
| 14 | {{info}} | ||
| 15 | Коннектор к таблицам Google построен на базе** SQLite** и поддерживает все команды **SQLite**. | ||
| 16 | {{/info}} | ||
| 17 | |||
| |
19.1 | 18 | (% class="wikigeneratedid" %) |
| 19 | Подключение состоит из шести последовательных шагов: | ||
| 20 | |||
| |
20.1 | 21 | (% class="wikigeneratedid" %) |
| 22 | Создание и базовая настройка проекта Google. | ||
| 23 | |||
| 24 | (% class="wikigeneratedid" %) | ||
| 25 | Создание и настройка сервисного аккаунта Google. | ||
| 26 | |||
| 27 | (% class="wikigeneratedid" %) | ||
| 28 | Делегирование полномочий на уровне домена. | ||
| 29 | |||
| |
13.1 | 30 | = Шаг 1. Создание и базовая настройка проекта Google = |
| |
1.2 | 31 | |
| |
5.1 | 32 | ---- |
| 33 | |||
| |
1.2 | 34 | **Проект Google** — функционал, использующийся для организации ресурсов Google. Проект состоит из: |
| 35 | |||
| 36 | * пользователей | ||
| 37 | * набора, аутентификации и мониторинга API | ||
| 38 | |||
| 39 | Пример функционала — сегменты и объекты Cloud Storage, разрешения пользователя на доступ к сегментам и объектам находятся в проекте. | ||
| 40 | |||
| |
3.1 | 41 | ~1. Выберите проект Google в [[**Google Cloud**>>https://console.cloud.google.com/]]. |
| |
1.2 | 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 | |||
| |
4.1 | 51 | 3. В открывшемся окне введите обязательные параметры проекта: |
| |
1.2 | 52 | |
| |
4.1 | 53 | * **Project name**. Имя проекта — идентификатор проекта. |
| 54 | * **Organization**. Поле отображается, если учетная запись Google, под которой вы вошли в систему, принадлежит организации. По умолчанию отображается домен организации. | ||
| 55 | * **Location**. Выберите из списка. | ||
| |
1.2 | 56 | |
| |
15.1 | 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]]. |
| |
14.1 | 58 | |
| |
20.1 | 59 | = Шаг 2. Создание и настройка сервисного аккаунта Google = |
| |
5.2 | 60 | |
| 61 | ---- | ||
| 62 | |||
| |
12.1 | 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]]. |
| |
5.2 | 64 | |
| |
9.1 | 65 | == Подшаг 2.1. Создание сервисного аккаунта Google == |
| 66 | |||
| |
6.1 | 67 | ~1. Нажмите кнопку **+ Create Service Account**. |
| |
5.2 | 68 | |
| |
7.1 | 69 | 2. В открывшемся окне введите параметры аккаунта: |
| |
6.1 | 70 | |
| 71 | * **Service account name**. Введите удобное для запоминания имя аккаунта. | ||
| 72 | * **Service account description**. Введите описание сервисного аккаунта. | ||
| 73 | |||
| 74 | 3. Нажмите кнопку **Create and Continue**. | ||
| 75 | |||
| |
7.1 | 76 | 4. Выберите значение в поле **Select a role**: |
| |
6.1 | 77 | |
| |
7.1 | 78 | * **Editor**: доступ к редактированию всех ресурсов учетной записи службы. |
| 79 | * **Owner**: полный доступ ко всем ресурсам сервисного аккаунта. | ||
| 80 | * **Viewer**: просмотр доступа ко всем ресурсам сервисного аккаунта. | ||
| 81 | |||
| 82 | {{warning}} | ||
| 83 | Если выбран вариант //Просмотр //— вы не сможете выполнить загрузку файла CSV. | ||
| 84 | {{/warning}} | ||
| 85 | |||
| 86 | {{info}} | ||
| |
25.1 | 87 | Доступно множественное создание ролей по кнопке **Add Another Role**. Также доступно удаление ролей. |
| |
7.1 | 88 | {{/info}} |
| 89 | |||
| |
8.1 | 90 | (% class="box infomessage" %) |
| 91 | ((( | ||
| 92 | **Grant users access to this service account** можно пропустить. | ||
| 93 | ))) | ||
| 94 | |||
| 95 | 5. Нажмите кнопку **Done**. | ||
| 96 | |||
| |
9.1 | 97 | == Подшаг 2.2. Создание ключа JSON == |
| |
8.1 | 98 | |
| |
9.1 | 99 | ~1. В столбце **Actions** таблицы проектов нажмите троеточие и выберите **Manage Keys**. |
| |
8.1 | 100 | |
| |
9.1 | 101 | 2. В открывшейся форме нажмите на кнопку **Add Key** и выберите **Create new key**. |
| 102 | |||
| 103 | 3. В открывшейся форме выберите тип ключа //JSON //и нажмите кнопку **Create**. | ||
| 104 | |||
| |
21.1 | 105 | 4. Сохраните файл с ключом //JSON//. |
| 106 | |||
| |
9.1 | 107 | (% class="box successmessage" %) |
| 108 | ((( | ||
| |
16.1 | 109 | В результате действий **Шага 1**: |
| |
9.1 | 110 | |
| 111 | * Создан проект и сервисный аккаунт Google. | ||
| 112 | * Добавлен ключ JSON. | ||
| 113 | ))) | ||
| 114 | |||
| |
20.1 | 115 | = Шаг 3. Делегирование полномочий на уровне домена = |
| |
9.1 | 116 | |
| |
18.1 | 117 | ---- |
| 118 | |||
| |
21.1 | 119 | Делегирование полномочий на уровне домена означает, что мы автоматически авторизуем сервисный аккаунт для доступа к пользовательским данным в домене Google Workspace. |
| |
9.1 | 120 | |
| |
21.1 | 121 | ~1. Откройте новую вкладку в браузере и перейдите по этой [[ссылке>>https://admin.google.com/ac/accountchooser?continue=https://admin.google.com/ac/owl/domainwidedelegation]]. |
| |
17.1 | 122 | |
| |
21.1 | 123 | 2. В поле **Client ID** вставьте **Unique ID** из сервисного аккаунта. |
| |
17.1 | 124 | |
| |
21.1 | 125 | 3. Заполните группу полей **OAuth scopes**, чтобы предоставить доступ к этим сервисам Google: |
| 126 | |||
| |
17.1 | 127 | * https:~/~/www.googleapis.com/auth/spreadsheets.readonly |
| 128 | * https:~/~/www.googleapis.com/auth/drive.readonly | ||
| 129 | * https:~/~/spreadsheets.google.com/feeds | ||
| 130 | |||
| |
21.1 | 131 | 4. Нажмите кнопку **Authorize**. |
| |
17.1 | 132 | |
| |
21.1 | 133 | = Шаг 4. Включение API = |
| |
17.1 | 134 | |
| |
21.1 | 135 | ---- |
| 136 | |||
| 137 | ~1. Проверьте, что вы в нужной учетной записи Google. | ||
| 138 | |||
| |
23.1 | 139 | 2. Перейдите по ссылке** [[Google Sheets API>>https://console.cloud.google.com/apis/api/sheets.googleapis.com/overview?project=grand-practice-409214]]** в консоли **Google Cloud Platform **и нажмите кнопку **Enable**. |
| |
21.1 | 140 | |
| |
23.1 | 141 | 3. Перейдите по ссылке** [[Google Drive API>>https://console.cloud.google.com/apis/api/drive.googleapis.com/overview?project=grand-practice-409214]]** в консоли **Google Cloud Platform **и нажмите кнопку **Enable**. |
| |
21.1 | 142 | |
| 143 | {{success}} | ||
| 144 | Настройка Google полностью завершена. | ||
| 145 | {{/success}} | ||
| 146 | |||
| |
25.1 | 147 | = Шаг 5. Настройка подключения к БД = |
| |
21.1 | 148 | |
| |
25.1 | 149 | ---- |
| 150 | |||
| |
24.1 | 151 | ~1. В разделе **Настройки** перейдите в **Данные, **затем нажмите кнопку **Подключить Google таблицы**. |
| |
23.1 | 152 | |
| |
24.1 | 153 | 2. В открывшейся форме: |
| |
23.1 | 154 | |
| |
24.1 | 155 | 2.1. Укажите следующие данные: |
| |
23.1 | 156 | |
| |
24.1 | 157 | * отображаемое имя |
| |
25.1 | 158 | * допустимый тип Google таблиц. Выберите //Public and privately shared sheets//. |
| |
24.1 | 159 | |
| |
30.1 | 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]]. |
| |
24.1 | 161 | |
| |
25.1 | 162 | == Вариант 1: Загрузить JSON-файл == |
| |
24.1 | 163 | |
| |
25.1 | 164 | ~1. В поле **Загрузить учетные данные** выберите заранее загруженный JSON-файл. |
| 165 | |||
| 166 | В результате файл появится в списке. | ||
| 167 | |||
| 168 | 2. При необходимости удалите загруженный в **Cloud BI** файл. | ||
| 169 | |||
| |
27.1 | 170 | == Вариант 2: Скопировать и вставить JSON-данные == |
| |
25.1 | 171 | |
| 172 | ~1. В поле **Сервисный аккаунт** вставьте код JSON. | ||
| 173 | |||
| |
32.1 | 174 | [[image:Скопировать и вставить JSON-данные.PNG||data-xwiki-image-style-border="true" height="897" width="743"]] |
| |
25.1 | 175 | |
| |
32.1 | 176 | 3. Подключите Google таблицы для БД. |
| |
25.1 | 177 | |
| |
32.1 | 178 | 3.1. Откройте новую вкладку и перейдите в свою личную таблицу Google. Скопируйте ссылку на таблицу с ограниченным доступом в буфер обмена. |
| |
25.1 | 179 | |
| |
32.1 | 180 | 3.2. Подключите Google таблицу. Введите данные: |
| 181 | |||
| 182 | * Название листа | ||
| 183 | * Ссылку на таблицу Google. | ||
| 184 | |||
| 185 | {{info}} | ||
| 186 | Дополнительные таблицы добавляются по кнопке **+Добавить лист**. | ||
| 187 | {{/info}} | ||
| 188 | |||
| 189 | 4. Нажмите кнопку **Подключить.** | ||
| 190 | |||
| |
34.1 | 191 | [[image:Подключение к таблицам Гугл.PNG||data-xwiki-image-style-border="true" height="1268" width="741"]] |
| |
32.1 | 192 | |
| |
33.1 | 193 | 5. При необходимости настройте дополнительные параметры подключения к БД. |
| |
32.1 | 194 | |
| |
34.1 | 195 | 6. Чтобы завершить подключение, нажмите кнопку **Готово**. |
| 196 | |||
| 197 | Шаг 6. Добавление датасета | ||
| 198 | |||
| 199 | **Датасет** или// //набор данных — механизм хранения информации, который предоставляет быстрый доступ к большим объемам данных. Датасеты создаются из таблиц базы данных или SQL-запросов. | ||
| 200 | |||
| 201 | ~1. Нажмите кнопку **Датасет **в реестре. | ||
| 202 | |||
| 203 | 2. В открывшемся окне выберете: | ||
| 204 | |||
| 205 | * **Базу данных**. выберите имя базы данных, которое вы определили на шаге 5 в пункте 2.1. | ||
| 206 | * **Схему**. | ||
| 207 | * **Таблицу БД**. | ||
| 208 | |||
| 209 | 3. Нажмите кнопку **ADD DATASET AND CREATE CHART**. | ||
| 210 | |||
| 211 | |||
| |
1.2 | 212 |