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