Подключение
Взаимодействие через официальный API
Last updated
Взаимодействие через официальный API
Last updated
Возможность подключения работы с Google таблицами в несколько кликов. Без сложностей.
1. На странице интеграций нажмите на кнопку «Подключить Google 2.0».
2. Затем выберите ваш аккаунт Google в открывшейся странице
3. На следующем шаге обязательно укажите пункт "Создание, просмотр, изменение и удаление ваших таблиц Google". Для того, чтобы интеграция с таблицами могла работать.
4. Затем нажмите кнопку "Продолжить".
После успешного подключения, вы попадете на страницу интеграций и увидите информацию о том, что Google 2.0 успешно подключен
А сама интеграция и её название появилось в списке подключенных интеграций:
Отлично. Теперь вы можете работать с таблицей прямо из бота. Подробности уже тут:
Для того, чтобы изменить название - можно нажать кнопку "Изменить настройки". Если понадобится удалить подключение, то нажмите кнопку "Удалить".
Интеграция Google 2.0 выполняет действия с таблицами от лица аккаунта, указанного в шаге 2. Соответственно, работа возможна только с таблицами, к которым этот аккаунт имеет доступ или является их создателем.
Этот способ подключения необходим тем, кто не хочет зависеть от общих лимитов.
Начальная страница в видео - https://console.cloud.google.com/cloud-resource-manager
Видео специально сделано без звука - мы заботимся о том, чтобы вам было удобно просматривать его вне зависимости от обстоятельств.
Подключение к таблицам создается через сервисный аккаунт Google.
Зайдите на страницу - https://console.cloud.google.com/cloud-resource-manager
Вам может быть предложено войти в свой аккаунт или зарегистрировать новый - проследуйте по всем шагам. Обратите внимание, что сейчас России официально нет в списке стран, где функционирует Google, поэтому выберите любую другую страну, если вас попросят определиться со страной (фактически этот выбор на функционал не влияет).
После входа вы увидите страницу с проектами:
Нажмите кнопку Create Project (cоздать проект)
На странице создания укажите любое название, затем нажмите Create (создать)
Запустится процесс создания проекта. В правом верхнем углу вы увидите окно прогресса. Как только проект будет создан вы увидите информацию, как на скриншоте ниже. Нам нужно зайти в проект для его настройки - для этого нажмите на SELECT PROJECT (выбрать проект)
Если у вас не видно окна, как на скриншоте выше - обновите страницу и около проекта с вашим названием нажмите на три точки и выберите пункт Settings (настройки)
После того, как мы попали в проект, нужно подключить возможность работы с Google Sheets (гугл таблицами).
Для этого:
Нажмите на меню слева сверху
В открывшемся окне наведите курсор на APIs & Services (API и сервисы)
Выберите вкладку Dashboard (панель управления)
На открывшейся странице нажмите на кнопку Enable APIs and Services (Включить API и сервисы)
Перед вами откроется окно поиска. В него нужно ввести Google sheets и нажать Enter для того, чтобы запустить поиск
Поиск выведет такой результат. Нажмите на кнопку с Google Sheets API
После, на открывшейся странице нажмите Enable (Включить). Запустится процесс подключения этого модуля.
После того, как модуль подключится, вы увидите страницу с информацией по использованию этого модуля. Сейчас она нам не интересна, но в будущем вы сможете смотреть всю статистику использования в удобном формате.
Нам нужно получить секретный ключ, который будет использоваться в подключении интеграции.
Для этого:
Откройте меню сверху слева
Выберите APIs & Services (API и сервисы)
Выберите пункт Credentials (реквизиты для входа)
В открывшемся окне нажмите Create Credentials
Выберите пункт Service account (сервисный аккаунт)
Если вы не находите пунктов со скриншотов выше, то нахождение кнопки создания сервисного аккаунта показано на скриншоте ниже.
В открывшейся форме создания укажите любое название для проекта. Затем нажмите Create and Continue (создать и продолжить), затем снизу на кнопку Done (завершить)
Запустится процесс создания сервисного аккаунта. Иногда он сразу создается, иногда нужно подождать какое-то время. Если у вас ещё не создался аккаунт, то вы увидите фразу, как на скриншоте ниже. Нужно просто подождать и обновить страницу.
После того, как аккаунт создался - вы увидите его email.
Важно. Сохраните себе этот email. Он пригодится нам в дальнейшем.
Кликните по email, чтобы зайти в настройки сервисного аккаунта.
В открывшейся странице нас интересует вкладка Keys (ключи). Нажмите на неё. Затем нажмите Add key (добавить ключ) и выберите пункт Create new Key (создать новый ключ)
В окне выбора оставьте формат JSON и нажмите create (создать)
Сохраните себе файл. В некоторых браузерах файл скачивается автоматически без каких-либо окон. Просто откройте загрузки, чтобы увидеть его.
Открыть файл можно любым текстовым редактором. Например, блокнотом.
Внутри файла лежит вся нужная нам информация.
На этом получение ключа для интеграции завершено. Переходим в Модератор.
Создайте новую интеграцию. В левом меню - Инструменты - Интеграции. В окне добавлении интеграции выберите пункт Google Таблицы.
Откроются поля подключения.
Название интеграции - укажите любое удобное вам название
Ключ - вставьте туда всё содержимое из файла, который мы получили в подключении Google.
И нажмите "Сохранить". Интеграция будет успешно добавлена. Вы великолепны!
Самый важный момент: выдать на наш сервисный email доступ к таблице.
Тут есть 2 варианта: конфиденциальный и открытый.
В настройках доступа страницы создайте ссылку с правами "Редактор" и всё. Теперь эту ссылку можно будет использовать для работы интеграции.
Заходите в нужную вам таблицу, нажимайте кнопку «Настройки доступа»
2. В поле добавления вставьте сервисный email (который мы сохраняли выше)
3. Важно, чтобы права были "Редактор". Нажмите "отправить", чтобы открыть доступ.
На этом настройка закончена. Теперь вы готовы работать с таблицей!
В случае, если вам нужно очень часто взаимодействовать с таблицей, используется подключение через сервисный аккаунт с добавлением дополнительных ключей.
Каждый дополнительный ключ нужно получить также, как и основной (пункт с созданием проекта можно пропустить и сразу перейти к пункту Создание сервисного аккаунта). Инструкция.
Каждый email от доп. ключей нужно добавлять в права доступа к таблице. Как это сделать показано в пункте выше.
