Настройка подключения Google Таблиц
- ZL Support
Пожалуйста, ознакомьтесь с Правилами использования материалов на данном ресурсе
Оглавление:
Вступление
Для того, чтобы начать пользоваться 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
Для корректной работы 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)
Полезные ссылки