Google Sheets (Private) — онлайн-сервис от Google, предназначенный для создания и редактирования электронных таблиц. Сервис позволяет пользователям создавать таблицы, вносить в них данные, проводить вычисления, анализировать информацию и совместно работать над таблицами с другими пользователями в режиме реального времени. Также это таблицы, в которых владелец предоставляет права доступа определенным пользователям.

Этапы подключения Cloud BI к Google Sheets (Private)

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

1. Создание и базовая настройка проекта Google.
2. Создание и настройка сервисного аккаунта Google.
3. Делегирование полномочий на уровне домена.
4. Включение API.
5. Настройка подключения к БД.
6. Добавление датасета.

Шаг 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: просмотр доступа ко всем ресурсам сервисного аккаунта.

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

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

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

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

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

4. Сохраните файл с ключом 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.

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

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

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

• отображаемое имя таблицы
• допустимый тип 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.

2. Подключите Google таблицы для БД.

   2.1. Откройте новую вкладку и перейдите в свою личную таблицу Google. Скопируйте ссылку на таблицу с ограниченным доступом в буфер обмена.

   2.2. Подключите Google таблицу. Введите данные:

• Название листа.
• Ссылку на таблицу Google.

3. Нажмите кнопку Подключить.

4. При необходимости настройте дополнительные параметры подключения к БД.

5. Чтобы завершить подключение, нажмите кнопку Готово.

Шаг 6. Добавление датасета

Датасет или набор данных — механизм хранения информации, который предоставляет быстрый доступ к большим объемам данных. Датасеты создаются из таблиц базы данных или SQL-запросов.

1. Нажмите кнопку Датасет в реестре.

2. В открывшемся окне выберете:

• Базу данных. Выберите имя базы данных, определенное в пункте 2.1 шага 5.
• Схему.
• Таблицу БД. 

3. Нажмите кнопку ADD DATASET AND CREATE CHART.

См. также

• Подключение к БД
• Создание и настройка графиков

• Создание и настройка датасетов