В кратких руководствах объясняется, как настроить и запустить приложение, вызывающее API Google Workspace.
В кратких руководствах по Google Workspace клиентские библиотеки API используются для обработки некоторых деталей процесса аутентификации и авторизации. Мы рекомендуем вам использовать клиентские библиотеки для ваших собственных приложений. В этом кратком руководстве используется упрощенный подход к аутентификации, подходящий для среды тестирования. В производственной среде мы рекомендуем изучить аутентификацию и авторизацию, прежде чем выбирать учетные данные доступа , подходящие для вашего приложения.
Создайте скрипт Google Apps , который отправляет запросы к API Google Chat.
Цели
- Настройте среду.
- Создайте и настройте скрипт.
- Запустите сценарий.
Предварительные условия
- Аккаунт Google Workspace для бизнеса или предприятия с доступом к Google Chat .
Настройте свой облачный проект
Если вы используете новый проект Google Cloud для выполнения этого краткого руководства, вам необходимо настроить его и добавить себя в качестве тестового пользователя. Если вы уже выполнили эти шаги для своего облачного проекта, перейдите к следующему разделу.
Откройте свой облачный проект в консоли Google Cloud.
Если он еще не открыт, откройте проект Cloud, который вы собираетесь использовать для этого примера:
- В консоли Google Cloud перейдите на страницу «Выбор проекта» .
- Выберите проект Google Cloud, который вы хотите использовать. Или нажмите «Создать проект» и следуйте инструкциям на экране. Если вы создаете проект Google Cloud, вам может потребоваться включить для него оплату .
Включите API чата
Прежде чем использовать API Google, вам необходимо включить их в проекте Google Cloud. Вы можете включить один или несколько API в одном проекте Google Cloud.В консоли Google Cloud включите API Google Chat.
Настройка экрана согласия OAuth
- В консоли Google Cloud выберите > API и службы > Экран согласия OAuth .
- В качестве типа пользователя выберите «Внутренний» , затем нажмите «Создать» .
- Заполните форму регистрации приложения, затем нажмите « Сохранить и продолжить» .
На данный момент вы можете пропустить добавление областей и нажать « Сохранить и продолжить» . В будущем, когда вы создадите приложение для использования за пределами вашей организации Google Workspace, вам необходимо изменить тип пользователя на Внешний , а затем добавить области авторизации, необходимые вашему приложению.
- Просмотрите сводку регистрации приложения. Чтобы внести изменения, нажмите «Изменить» . Если регистрация приложения выглядит нормально, нажмите «Вернуться на панель управления» .
Настройте приложение Google Chat
Чтобы вызвать API Google Chat, необходимо настроить приложение Google Chat. Для любых запросов на запись Google Chat атрибутирует приложение Google Chat в пользовательском интерфейсе, используя следующую информацию.
В консоли Google Cloud перейдите на страницу конфигурации Chat API:
В разделе «Информация о приложении» введите следующую информацию:
- В поле «Имя приложения» введите
Chat API quickstart app
. - В поле URL-адрес аватара введите
https://developers.google.com/chat/images/quickstart-app-avatar.png
. - В поле «Описание» введите
Quickstart for calling the Chat API
.
- В поле «Имя приложения» введите
В разделе «Интерактивные функции» установите переключатель «Включить интерактивные функции» в положение «Выкл.», чтобы отключить интерактивные функции для приложения Chat.
Нажмите Сохранить .
Создать сценарий
- Создайте новый скрипт, перейдя по адресу script.google.com/create .
- Замените содержимое редактора скриптов следующим кодом:
- Нажмите «Сохранить».
.
- Нажмите «Проект без названия» , введите «Quickstart» и нажмите «Переименовать» .
Настройте сценарий
Скопируйте номер облачного проекта
- В консоли Google Cloud выберите > IAM и администрирование > Настройки .
- В поле Номер проекта скопируйте значение.
Свяжите свой проект Google Cloud
- Откройте проект Apps Script.
- Нажмите параметров проекта» .
- В разделе «Проект Google Cloud Platform (GCP)» нажмите « Изменить проект» .
- В поле «Номер проекта GCP» вставьте номер проекта Google Cloud.
- Нажмите Установить проект .
Включите API Чата Google
- Откройте проект Apps Script.
- Нажмите параметров проекта» .
- В разделе «Общие настройки» включите «Показывать файл манифеста «appsscript.json» в редакторе» .
- Нажмите
appscript.json
и замените его содержимое следующим кодом: редактора» , выберите файл
Запустите образец
В редакторе Apps Script нажмите «Выполнить» .
При первом запуске примера вам будет предложено авторизовать доступ:
- Нажмите «Просмотреть разрешения» .
- Выберите учетную запись.
- Нажмите Разрешить .
Журнал выполнения скрипта отображается в нижней части окна.