Подготовка таблицы

Что сделать в Google Таблицах до подключения: создать таблицу, открыть доступ и взять ссылку

Заводить проект в Google Cloud, включать API и скачивать JSON-ключ не нужно — сервисный аккаунт уже настроен на стороне сервиса. От вас нужны только сама таблица, доступ к ней и ссылка на неё.

Шаг 1. Создайте таблицу

Откройте Google Таблицы и создайте новую таблицу — или возьмите ту, с которой уже работаете. Название таблицы любое, сервис его не проверяет.

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

Адрес показан в кабинете — это тот аккаунт, которому вы откроете доступ к таблице.

  1. Откройте API подключение — пункт «API подключение» в меню пользователя (правый верхний угол кабинета).
  2. Найдите карточку «Google Sheets».
  3. В строке «Сервисный аккаунт» нажмите значок копирования рядом с адресом — появится уведомление «Email скопирован».
СкриншотКарточка «Google Sheets» на странице «API подключение» в состоянии «Не подключено»: строка «Сервисный аккаунт» с адресом и кнопкой копирования, строка «Таблица» со значением «Не подключена», кнопка «Подключить» в шапке карточки.

Шаг 3. Откройте таблице доступ с ролью «Редактор»

  1. Откройте свою таблицу в браузере.
  2. Нажмите «Поделиться» в правом верхнем углу (в части версий интерфейса Google этот пункт называется «Настройки доступа»).
  3. Вставьте скопированный адрес сервисного аккаунта.
  4. Выберите роль «Редактор».
  5. Нажмите «Отправить».
Роль «Читатель» не подойдёт: сервис не только читает таблицу, но и записывает в неё результаты. Пока доступ не выдан, таблица для сервиса вообще не существует — проверка подключения ответит «Таблица не найдена или ей не открыт доступ для сервисного аккаунта».
Эти же пять шагов всегда под рукой в кабинете: кнопка «Как?» рядом с адресом сервисного аккаунта открывает их окном. То же окно сервис показывает сам, если упёрся в отсутствие доступа.

Шаг 4. Скопируйте ссылку на таблицу

Ссылка — это адрес открытой таблицы из адресной строки браузера:

https://docs.google.com/spreadsheets/d/1AbCdEfGhIjKlMnOpQrStUvWxYz/edit

Копируйте её целиком — выделять идентификатор из середины адреса не нужно, сервис возьмёт его сам.

Таблица готова. Дальше — Подключение таблицы.