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

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

Оглавление:

Вступление

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

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

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

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

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

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

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

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

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

 

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

 

  • Введите любое название проекта в поле 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

В этом режиме каждые 7 дней будет необходимо переавторизоваться в приложении (на май 2021 года. В последствии Google может изменить этот срок). Ссылка на справку Google.

Количество тестовых пользователей ограничено - их может быть не больше 100!
После добавления пользователя в список тестеров удалить его оттуда уже нельзя!

Можно оставить приложение в тестовом режиме. Тогда оно будет доступно только для аккаунта-создателя и пользователей, которые добавлены в список 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

Внимание! Очень важно включить оба API, иначе программа будет работать не корректно.

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

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

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

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

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

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

Таблицы надо подключать отдельно в ProjectMaker и ZennoPoster

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

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

Файл обязательно должен иметь расширение .json!

 

  • После этого, откроется окно браузера, где необходимо будет войти в свой аккаунт 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)


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