Настройка подключения Google Таблиц

Оглавление:

Вступление

Для того, чтобы начать пользоваться Google-таблицами в ZennoPoster, нужно выполнить следующие действия.

Создание нового ключа Google API

Создание нового приложения

• Войдите в свой Google аккаунт или создайте новый.

• Зайдите в Google Cloud Platform. При первом заходе на сайт надо будет:

  • выбрать страну (1)

  • прочитать правила использования сервисов и, если Вы согласны с ними, принять их, отметив соответствующую настройку (2)

  • (опционально) согласиться на рассылку по email (3)

  • в конце нажать AGREE AND CONTINUE (4)

    Open

    

• Выберите раздел OAuth consent screen (1) и нажмите CREATE PROJECT (2).
  Будет создан новый проект.

  Open

  

• Введите любое название проекта в поле Project name (1), но только на английском языке, Location (Местоположение, если нужно) (2) и нажмите CREATE(3).

• В следующем окне выберите External (1) и нажмите CREATE (2)

• В открывшемся окне надо ввести любое имя приложения в поле App name (1), выбрать email в списке User support email (2)

• Прокрутите страницу в самый низ и ещё раз введите свой email (3) и нажмите SAVE AND CONTINUE (4)

• В следующем окне (Scopes) просто проматываем страницу в самый низ и нажимаем SAVE AND CONTINUE.

• В окне Test users тоже пролистываем вниз и нажимаем SAVE AND CONTINUE.

• В новом окне (Summary) пролистываем вниз и нажимаем BACK TO DASHBOARD.

Публикация проекта

Testing mode

Можно оставить приложение в тестовом режиме. Тогда оно будет доступно только для аккаунта-создателя и пользователей, которые добавлены в список Test Users, для этого:

• на вкладке OAuth consent screen пролистайте чуть вниз и в разделе Test users нажмите кнопку +ADD USERS.

• в открывшемся окне добавьте email адрес необходимого аккаунта и нажмите кнопку SAVE.

  
  
  

Publish App

Так же Вы можете опубликовать приложение. Тогда оно будет доступно всем пользователям у которых есть Google аккаунт.

В открывшемся окне нажмите кнопку PUBLISH APP

• CONFIRM во всплывающем окне

Создание учётных данных

• В разделе Credentials (1) нажмите CREATE CREDENTIALS (2) и выберите пункт OAuth client ID (3)

• Выберите пункт Desktop app в выпадающем списке Application type (1) и нажмите CREATE (2)

• Откроется новое окно OAuth client created, в нём нажмите OK.

• После этого кликните либо по названию только что созданного приложения либо по значку его редактирования

• В открывшемся окне необходимо скачать ключ в виде файла, для этого нажмите кнопку DOWNLOAD JSON.

Включение использования API Google Sheets и Drive

Для корректной работы Google-таблиц осталось совсем не много!

• Для включения Google Sheets API, перейдите по этой ссылке.

• Выберите Ваш проект (1) и нажмите ENABLE (2).

• Для включения Google Drive API, перейдите по этой ссылке.

• Выберите Ваш проект (1) и нажмите ENABLE (2).

Добавление ключа в программу

• Откройте настройки Google таблиц (Редактирование => Настройки => Google таблицы)

• Нажмите […] и выберите файл учётных данных (1), нажмите Подключить (2).

• После этого, откроется окно браузера, где необходимо будет войти в свой аккаунт Google, где Вы создавали ключ.

• Так как Вы только что создали свое приложение, может появиться окно с предупреждением. Поскольку, Вы доверяете своему приложению, необходимо выбрать Дополнительные настройки (1) и Перейти на страницу "Ваше приложение" (2).

• После этого, разрешите доступ Вашего нового приложения к данным вашего аккаунта, чтобы можно было читать и записывать таблицы.

• Затем снова:

• После этого в браузере появится надпись Received verification code. You may now close this window - это означает что всё было сделано правильно! Можете закрыть эту вкладку браузера.

Лимиты запросов к API

Какие есть ограничения?

Есть ограничения на количество запросов: 50 000 запросов в сутки на один проект и 10 запросов в секунду на один IP-адрес (эти лимиты актуальны на май 2021 года).

Где можно увидеть текущее количество сделанных запросов?

Вы можете найти эту информацию в Dashboard'е Google Cloud Platform (не забудьте выбрать правильный проект).

Как увеличить лимиты?

Информацию о том, как расширить лимиты Вы можете найти по этой ссылке - Запрос дополнительной квоты.

Как ZennoPoster расходует лимиты?

На количество запросов, в упрощенном виде, влияют два фактора - изменялась ли таблица и включена ли загрузка сторонних изменений (настройка Политика обработки изменений таблицы).

Если загрузка сторонних изменений включена, то каждую минуту будет отправляться запрос к Drive API для сравнения версий таблиц.

При изменении самой таблицы используются разные виды запросов, в целом до 5 запросов на таблицу в минуту. Т.е. если активно меняются 10 таблиц, то будет максимум около 60 запросов в минуту (Sheets API + Drive API).

Возможные ошибки

Ошибка авторизации (Ошибка 403: access_denied)

Полезные ссылки

• Операции над Google-таблицами

• Google таблицы (PM)

• Многопоточная работа с Google-таблицами (Версия 7.1.7.0 и выше)