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