В этом разделе описываются распространенные проблемы, с которыми вы можете столкнуться при создании и тестировании приложений чата.
Предварительный просмотр сообщения, диалогового окна или ссылки не отображается или не работает должным образом
Для получения помощи по устранению ошибок карт см. раздел Устранение неполадок и исправление ошибок карт .
Приложение не отвечает
Если вы отправляете сообщение в приложение Chat и оно отвечает «Приложение не отвечает», проверьте конфигурацию приложения Chat:
В консоли Google Cloud нажмите Меню Дополнительные продукты > Google Workspace > Библиотека продуктов > Google Chat API > Управление > Конфигурация .
В разделе «Статус приложения» убедитесь, что выбрано значение «В режиме реального времени — доступно пользователям» .
В разделе Интерактивные функции убедитесь, что настройки соответствуют функциональности вашего приложения. Если ваше приложение Chat взаимодействует с пользователями, убедитесь, что вы включили Включить интерактивные функции :
- Если ваше приложение отвечает на сообщения, обязательно выберите «Принимать сообщения 1:1» .
- В разделе «Параметры подключения» убедитесь, что URL-адрес конечной точки HTTP , идентификатор развертывания проекта Apps Script, имя темы Cloud Pub/Sub или агент Dialogflow настроены правильно и развернуты.
- В разделе Видимость убедитесь, что у соответствующих пользователей есть доступ к приложению с адресом электронной почты или группой в домене Google Workspace. Если приложение развернуто с помощью Google Workspace Marketplace SDK , настройки видимости не нужны, поскольку настройки Google Workspace Marketplace имеют приоритет.
Если приложение опубликовано с помощью Google Workspace Marketplace SDK , проверьте настройки Google Workspace Marketplace.
Нажмите «Сохранить» .
Попробуйте отправить сообщение в приложение еще раз.
API Google Chat доступен только пользователям 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 запрещает пользователям включать или выключать историю чата , то могут возникнуть ситуации, когда пользователи не смогут присоединиться к пространству или оставаться в нем из-за конфликта между настройкой на уровне пользователя, которая принудительно включает или выключает историю чата, и пространством, которое наследует принудительную настройку на уровне организации.
Например, если у пользователя принудительно включена настройка истории чата, а у пространства принудительно выключена настройка истории чата, то этот пользователь может не иметь возможности присоединиться к пространству. Кроме того, этот пользователь может быть удален из пространства, если он присоединился до конфликта, а затем опубликовал сообщение в пространстве после конфликта.
В этом сценарии и других сценариях, где возникают конфликты между настройками истории, API чата может не позволить создать членство, или создание сообщения с аутентификацией пользователя может привести к удалению аутентифицированного пользователя с конфликтующей настройкой истории чата из пространства.
Дополнительную информацию см. в статье «Пользователи могут быть исключены из пространств» в Справочном центре администратора Google Workspace.
Устранение неполадок службы расширенного чата в скрипте Google Apps
Подробнее о службе расширенного чата см. на странице Apps Script.
Пользователи не могут добавить приложение чата в пространство
Если пользователи сталкиваются с сообщением об ошибке This organization's administrator must allow users to install this Chat app при попытке добавить приложение чата в пространство, эта ошибка может быть вызвана одной из следующих причин:
- Организация отключила приложения чата.
- Организация не добавила данное приложение 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>. - Если метод API чата поддерживает область авторизации
https://www.googleapis.com/auth/chat.bot, которая не требует одобрения администратора, рассмотрите возможность использования его вместо этого. Чтобы проверить, какие области авторизации поддерживает метод, см. Аутентификация и авторизация приложений Google Chat и запросы API Google Chat .
Устранение ошибок облачных функций
Если приложение чата реализовано с помощью облачных функций и не работает, следующие разделы помогут устранить неполадки и устранить проблему.
Проверьте журналы облачных функций
В качестве первого шага проверьте журналы облачных функций на наличие ошибок.
В консоли Google Cloud перейдите на страницу Cloud Functions:
Чтобы открыть журналы, найдите функцию Cloud вашего приложения Chat, затем нажмите Показать действия > Просмотреть журналы .
Открывается Logs Explorer и выполняется запрос, показывающий журналы Cloud Function, включая ошибки.
Если регистрируемой по умолчанию информации недостаточно для отладки вашего приложения, вы можете добавить дополнительную регистрацию из кода Cloud Function. См. Просмотр и запись журналов Cloud Function .
Проверить ошибки функции облака
Помимо журналов, Cloud Function может также сообщать об ошибках, возникших во время работы.
В консоли Google Cloud перейдите на страницу Cloud Functions:
Нажмите на функцию облака в приложении чата.
На странице сведений о функции ошибки перечислены в разделе Ошибки .
Для дальнейшего устранения ошибки щелкните по ней.
Исправление распространенных ошибок облачных функций
При создании приложения чата с использованием облачных функций иногда возникают следующие ошибки.
Функция ChatApp в регионе REGION_NAME в проекте PROJECT_NAME уже существует
При развертывании функции облака вы можете получить ошибку Function ChatApp in region REGION_NAME in project PROJECT_NAME already exists . Это сообщение означает, что другая функция облака имеет то же имя, что и развертываемая вами. Измените имя и разверните функцию снова. Убедитесь, что приложение Chat использует URL-адрес триггера для вашей функции облака, а не URL-адрес триггера ранее существовавшей функции облака.
Один или несколько пользователей, указанных в политике, не принадлежат к разрешенному клиенту.
При развертывании функции облака вы можете получить ошибку 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 не может связаться с сервером, на котором размещена функция облака. Это сообщение означает, что у пользователя с именем "allUsers" нет разрешения на вызов функции облака. Предоставление "allUsers" роли "Cloud Functions Invoker" означает, что функция облака, которая поддерживает приложение, общедоступна и доступна без аутентификации. Чтобы узнать, как назначить роль, см. раздел Предоставление одной роли .
Эта ошибка может означать, что проект Google Cloud ограничен доменом. Для получения дополнительной информации об ограничениях домена обратитесь к разделу Ограничение идентификаторов по домену .
Чтобы решить эту проблему, убедитесь, что ваша функция Cloud Function допускает неаутентифицированные вызовы. Чтобы узнать, как разрешить неаутентифицированные вызовы для существующей функции Cloud Function, см. Разрешение публичного (неаутентифицированного) доступа .