F21. Google Sheets (Private)

Версия 27.1 от Ирина Сафонова на 26.12.2023, 12:37
Предупреждение: Из соображений безопасности документ отображается в ограниченном режиме, поскольку это не текущая версия. Из-за этого могут быть расхождения и ошибки.
Содержание

Процесс подключения к Google Sheets (Private)

Раздел описывает, как подключиться к закрытым таблицам Google (Google Sheets (Private).

Коннектор к таблицам Google построен на базе SQLite и поддерживает все команды SQLite.

Подключение состоит из шести последовательных шагов:

Создание и базовая настройка проекта Google.

Создание и настройка сервисного аккаунта Google.

Делегирование полномочий на уровне домена.

Шаг 1. Создание и базовая настройка проекта Google

Проект Google — функционал, использующийся для организации ресурсов Google. Проект состоит из:

  • пользователей
  • набора, аутентификации и мониторинга API

Пример функционала — сегменты и объекты Cloud Storage, разрешения пользователя на доступ к сегментам и объектам находятся в проекте.

1. Выберите проект Google в Google Cloud.

    1.1 Убедитесь, что ваш аккаунт Google связан с необходимой таблицей Google.

    1.2. Выберите страну и ознакомьтесь с условиями использования Google Cloud.

    1.3. Выберите необходимый проект Google.

2. На вкладке Service Accounts нажмите кнопку Create Project.

3. В открывшемся окне введите обязательные параметры проекта:

  • Project name. Имя проекта — идентификатор проекта.
  • Organization. Поле отображается, если учетная запись Google, под которой вы вошли в систему, принадлежит организации. По умолчанию отображается домен организации.
  • Location. Выберите из списка.

4. Перейдите к созданию и настройке сервисного аккаунта Google.

Шаг 2. Создание и настройка сервисного аккаунта Google

Сервисные аккаунты — аккаунты Google для доступа приложений к менеджеру рекламы через API. Аккаунты не требуют персональной авторизации. Вместо этого используется файл ключа, доступ к которому есть только у вашего приложения. Сначала создайте сервисный аккаунт, затем — ключи JSON.

Подшаг 2.1. Создание сервисного аккаунта Google

1. Нажмите кнопку + Create Service Account.

2. В открывшемся окне введите параметры аккаунта:

  • Service account name. Введите удобное для запоминания имя аккаунта.
  • Service account description. Введите описание сервисного аккаунта.

3. Нажмите кнопку Create and Continue.

4. Выберите значение в поле Select a role:

  • Editor: доступ к редактированию всех ресурсов учетной записи службы.
  • Owner: полный доступ ко всем ресурсам сервисного аккаунта.
  • Viewer: просмотр доступа ко всем ресурсам сервисного аккаунта.

Если выбран вариант Просмотр — вы не сможете выполнить загрузку файла CSV.

Доступно множественное создание ролей по кнопке Add Another Role. Также доступно удаление ролей.

Grant users access to this service account можно пропустить.

5. Нажмите кнопку Done.

Подшаг 2.2. Создание ключа JSON

1. В столбце Actions таблицы проектов нажмите троеточие и выберите Manage Keys.

2. В открывшейся форме нажмите на кнопку Add Key и выберите Create new key.

3. В открывшейся форме выберите тип ключа JSON и нажмите кнопку Create.

4. Сохраните файл с ключом JSON.

В результате действий Шага 1:

  • Создан проект и сервисный аккаунт Google.
  • Добавлен ключ JSON.

Шаг 3. Делегирование полномочий на уровне домена

Делегирование полномочий на уровне домена означает, что мы автоматически авторизуем сервисный аккаунт для доступа к пользовательским данным в домене Google Workspace. 

1. Откройте новую вкладку в браузере и перейдите по этой ссылке.

2. В поле Client ID вставьте Unique ID из сервисного аккаунта.

3. Заполните группу полей OAuth scopes, чтобы предоставить доступ к этим сервисам Google: 

  • https://www.googleapis.com/auth/spreadsheets.readonly
  • https://www.googleapis.com/auth/drive.readonly
  • https://spreadsheets.google.com/feeds

4. Нажмите кнопку Authorize.

Шаг 4. Включение API

1. Проверьте, что вы в нужной учетной записи Google.

2. Перейдите по ссылке Google Sheets API в консоли Google Cloud Platform и нажмите кнопку Enable.

3. Перейдите по ссылке Google Drive API в консоли Google Cloud Platform и нажмите кнопку Enable.

Настройка Google полностью завершена.

Шаг 5. Настройка подключения к БД

1. В разделе Настройки перейдите в Данные, затем нажмите кнопку Подключить Google таблицы.

2. В открывшейся форме:

    2.1. Укажите следующие данные:

  • отображаемое имя
  • допустимый тип Google таблиц. Выберите Public and privately shared sheets.

Дальнейшая настройка зависит от значения в поле HOW DO YOU WANT TO ENTER SERVICE ACCOUNT CREDENTIALS?. Если выбрали Загрузить JSON-файл — перейдите к Вариант 1: Загрузить JSON-файл. Если выбрали Скопировать и вставить JSON-данные перейдите к Вариант 2: Скопировать и вставить JSON-данные.

Вариант 1: Загрузить JSON-файл

1. В поле Загрузить учетные данные выберите заранее загруженный JSON-файл.

В результате файл появится в списке.

2. При необходимости удалите загруженный в Cloud BI файл.

Вариант 2: Скопировать и вставить JSON-данные

1. В поле Сервисный аккаунт вставьте код JSON.

Загрузить JSON-файл.PNG