В этом разделе описаны распространенные проблемы, которые могут возникнуть при создании и тестировании приложений Chat.
Карточка, диалоговое окно или предпросмотр ссылки не отображаются или работают неправильно
Если у вас возникли проблемы с карточками, ознакомьтесь с разделом Как устранять неполадки с карточками.
Приложение не отвечает
Если вы отправили сообщение в приложение Chat и получили ответ "Приложение не отвечает", проверьте конфигурацию приложения Chat:
В Google API Console нажмите Меню > API и сервисы > Включенные API и сервисы > Google Chat API > Конфигурация.
В разделе Интерактивные функции убедитесь, что настройки соответствуют функциям вашего приложения. Если ваше приложение Chat взаимодействует с пользователями, включите интерактивные функции:
- По умолчанию приложения могут отвечать на прямые сообщения от пользователей.
- Если ваше приложение отвечает на сообщения в чат-группах и групповых чатах, выберите Присоединяться к чат-группам и групповым чатам.
- В разделе Настройки подключения убедитесь, что архитектура и триггеры (например, URL конечной точки HTTP, идентификатор развертывания и название функции проекта Apps Script, название темы Cloud Pub/Sub или агент Dialogflow) заданы правильно и приложение развернуто.
- В разделе Видимость убедитесь, что у нужных пользователей есть доступ к приложению с помощью адреса электронной почты или группы в домене Google Workspace. Если приложение развернуто с помощью Google Workspace Marketplace SDK, настройки видимости не нужны, поскольку приоритет имеют настройки Google Workspace Marketplace.
Если приложение опубликовано с помощью Google Workspace Marketplace SDK, проверьте настройки Google Workspace Marketplace.
Нажмите Сохранить.
Попробуйте отправить сообщение ещё раз.
Google Chat API доступен только пользователям Google Workspace
При настройке приложения Chat может появиться ошибка Google Chat API is only available to Google Workspace users. Это сообщение означает, что аккаунт Google, который вы использовали для настройки Chat API, не входит в организацию Google Workspace. Чтобы создать приложение Chat или использовать Chat API, вам понадобится аккаунт Google Workspace.
Обратите внимание, что пользователи Google Chat могут использовать приложения Chat без аккаунта Google Workspace. Чтобы узнать больше о том, как пользователи находят и устанавливают приложения Chat, ознакомьтесь со статьей Создание интерактивных приложений Google Chat.
Пользователи могут лишаться доступа к чат-группам
Если администратор Google Workspace запретил пользователям включать или отключать историю чата, в некоторых случаях пользователи могут лишиться доступа к чат-группе или возможности присоединиться к ней из-за конфликта между настройкой на уровне пользователя, которая принудительно включает или отключает историю чата, и настройкой на уровне организации, которая принудительно применяется к чат-группе.
Например, если для пользователя принудительно включена история чата, а для чат-группы – отключена, пользователь может не иметь возможности присоединиться к чат-группе. Кроме того, если пользователь присоединился к чат-группе до конфликта и отправил сообщение после него, он может быть удален из чат-группы.
В этом и других случаях, когда настройки истории чата конфликтуют, Chat API может не создать членство или при создании сообщения с аутентификацией пользователя удалить из чат-группы аутентифицированного пользователя с конфликтующими настройками истории чата.
Подробнее о том, как пользователи могут лишаться доступа к чат-группам…
Устранение неполадок с сервисом Advanced Chat в Google Apps Script
Ознакомьтесь со страницей Apps Script о расширенном сервисе Chat.
Пользователи не могут добавить приложение Chat в чат-группу.
Если при попытке добавить приложение Chat в чат-группу появляется сообщение об ошибке
This organization's administrator must allow users to install this Chat app, это может быть вызвано одной из следующих причин:
- В организации отключены приложения Chat.
- Организация не добавила это приложение Chat в белый список.
Если пользователь получает это сообщение об ошибке при попытке взаимодействовать с приложением Chat, возможно, организация предоставила доступ к дочернему организационному подразделению, не включив его для родительского организационного подразделения.
Информацию о том, как устранить эту проблему, можно найти в статье Как разрешить пользователям устанавливать приложения Chat.
Администратор должен предоставить приложению необходимую область авторизации OAuth для этого действия.
При аутентификации в качестве приложения Chat может появиться следующее сообщение об ошибке:
<HttpError 403 when requesting https://chat.googleapis.com/v1/spaces/{space}?alt=json returned "The administrator must grant the app the required OAuth authorization scope for this action.". Details: "The administrator must grant the app the required OAuth authorization scope for this action.">
Это сообщение об ошибке означает, что администратор Google Workspace ещё не предоставил приложению Chat однократное разрешение на использование областей авторизации, названия которых начинаются с https://www.googleapis.com/auth/chat.app.*.
Чтобы устранить ошибку:
- Попросите администратора Google Workspace предоставить разрешение для вашего приложения Chat. При обработке этой ошибки в логике приложения Chat рассмотрите возможность отправки сообщения о том, что для выполнения запрошенного действия приложению Chat требуется разрешение администратора, например:
To perform this action, I need approval. <https://support.google.com/a?p=chat-app-auth|Learn more>. - Если метод Chat API поддерживает область авторизации
https://www.googleapis.com/auth/chat.bot, которая не требует одобрения администратора, попробуйте использовать ее. Чтобы узнать, какие области действия авторизации поддерживает тот или иной метод, ознакомьтесь со статьей Как настроить аутентификацию и авторизацию для приложений для Chat и запросов API Google Chat.
Как устранять ошибки Cloud Functions
Если приложение Chat реализовано с помощью Cloud Functions и не работает, приведенные ниже разделы помогут устранить неполадку.
Проверьте журналы функций Cloud Functions
Для начала проверьте журналы Cloud Functions на наличие ошибок.
В Google API Console перейдите на страницу Cloud Functions:
Чтобы открыть журналы, найдите функцию Cloud Functions для приложения Chat и нажмите Показать действия > Посмотреть журналы.
Откроется интерфейс просмотра журналов и будет выполнен запрос, показывающий журналы функций Cloud Functions, в том числе ошибки.
Если информации, регистрируемой по умолчанию, недостаточно для отладки приложения, вы можете добавить дополнительное ведение журналов из кода функции Cloud Functions. Подробнее о том, как просматривать и записывать журналы функций Cloud…
Как проверить ошибки функции Cloud Functions
Помимо журналов, функция Cloud Functions может также сообщать об ошибках, возникших во время выполнения.
В Google API Console перейдите на страницу Cloud Functions:
Нажмите на функцию Cloud Function для приложения Chat.
На странице сведений о функции ошибки перечислены в разделе Ошибки.
Чтобы устранить ошибку, нажмите на нее.
Как устранять распространенные ошибки в Cloud Functions
При создании приложения Chat с помощью Cloud Functions иногда возникают следующие ошибки.
Функция ChatApp в регионе REGION_NAME в проекте PROJECT_NAME уже существует
При развертывании функции Cloud Functions может появиться ошибка Function
ChatApp in region REGION_NAME in project PROJECT_NAME already
exists. Это сообщение означает, что другая функция Cloud Functions имеет то же название, что и развертываемая вами. Измените название и снова разверните функцию. Убедитесь, что приложение Chat использует URL триггера для вашей функции Cloud Functions, а не URL триггера существующей функции Cloud Functions.
Один или несколько пользователей, указанных в правиле, не принадлежат разрешенному клиенту
При развертывании функции Cloud Functions может появиться ошибка The operation
cannot be completed on the function: "One or more users named in the policy do
not belong to a permitted customer.". Если после этого вы отправите сообщение в приложение Chat, то получите ошибку о том, что приложение не отвечает, поскольку Google Chat не может подключиться к серверу, на котором размещена функция Cloud Functions. Это сообщение означает, что у пользователя с именем allUsers нет разрешения на вызов функции Cloud Functions.
Если назначить роль "Вызывающий функцию Cloud Functions" группе allUsers, функция Cloud Functions, на которой работает приложение, станет общедоступной и будет вызываться без аутентификации. Чтобы узнать, как назначить роль, ознакомьтесь с разделом Как предоставить одну роль.
Эта ошибка может означать, что проект Google Cloud ограничен доменом. Дополнительную информацию об ограничениях домена можно найти в статье Как управлять ограничением доступа на уровне домена.
Чтобы устранить эту проблему, убедитесь, что ваша функция Cloud Function позволяет вызывать ее без аутентификации. Чтобы разрешить вызовы без аутентификации для существующей функции Cloud Functions, ознакомьтесь с разделом Как разрешить публичный доступ (без аутентификации).
Приложения Chat, которые не являются дополнениями: устранение неполадок и ошибок приложений Google Chat
Следующая документация относится к приложениям Chat, которые не являются дополнениями Google Workspace. Чтобы перенести приложение Chat, которое не является дополнением, ознакомьтесь со статьей Как преобразовать приложение Chat в дополнение Google Workspace.
Если приложение Chat, которое не является дополнением, отвечает "Приложение не отвечает", проверьте следующие настройки на вкладке Конфигурация API Chat в Google API Console:
- В разделе Статус приложения убедитесь, что выбран вариант Опубликовано – доступно пользователям.
- В разделе Интерактивные функции > Настройки подключения убедитесь, что URL конечной точки HTTP, идентификатор развертывания Apps Script, название темы Cloud Pub/Sub или агент Dialogflow настроены и развернуты.