В этом разделе описываются распространенные проблемы, с которыми вы можете столкнуться при создании и тестировании приложений чата.
Предварительный просмотр сообщения, диалогового окна или ссылки не отображается или не работает должным образом.
Информацию об устранении неполадок с картами см. в разделе Устранение неполадок и исправление ошибок карт .
Приложение не отвечает
Если вы отправляете сообщение в приложение Chat и оно отвечает: «Приложение не отвечает», проверьте конфигурацию приложения Chat:
В консоли Google Cloud выберите Меню Дополнительные продукты > Google Workspace > Библиотека продуктов > Google Chat API > Управление > Конфигурация .
В разделе «Статус приложения» убедитесь, что выбрано значение «Доступно пользователям» .
В разделе «Интерактивные функции» убедитесь, что настройки соответствуют функционалу вашего приложения. Если ваше приложение чата взаимодействует с пользователями, убедитесь, что включена опция «Включить интерактивные функции» :
- По умолчанию приложения могут отвечать на прямые сообщения пользователей.
- Если ваше приложение отвечает на сообщения в пространствах и групповых чатах, выберите Присоединяйтесь к пространствам и групповым беседам .
- В разделе «Настройки подключения» убедитесь, что 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, используемая для настройки API Chat, не принадлежит организации Google Workspace. Для создания приложения Chat или использования API Chat необходимо использовать учётную запись Google Workspace .
Обратите внимание, что пользователи Google Chat могут использовать приложения Chat без учётной записи Google Workspace. Подробнее о том, как пользователи находят и устанавливают приложения Chat, см. в статье «Создание интерактивных приложений Google Chat» .
Пользователи могут быть исключены из пространств
Если администратор Google Workspace запрещает пользователям включать и выключать историю чата , то могут возникнуть ситуации, когда пользователи не смогут присоединиться к пространству или оставаться в нем из-за конфликта между настройкой уровня пользователя, которая принудительно включает или выключает историю чата, и пространством, которое наследует принудительную настройку уровня организации.
Например, если у пользователя принудительно включена настройка истории чата, а в чат-группе принудительно выключена настройка истории чата, то этот пользователь может не присоединиться к чат-группе. Кроме того, этот пользователь может быть удалён из чат-группы, если он присоединился до конфликта, а затем опубликовал сообщение в чат-группе после него.
В этом сценарии и других сценариях, где возникают конфликты между настройками истории, API чата может не иметь возможности создать членство, или создание сообщения с аутентификацией пользователя может привести к удалению аутентифицированного пользователя с конфликтующей настройкой истории чата из пространства.
Дополнительную информацию см. в статье «Пользователи могут быть исключены из пространств» в справочном центре администратора Google Workspace.
Устранение неполадок службы расширенного чата в скрипте Google Apps
Подробнее о службе расширенного чата см. на странице «Скрипт приложений».
Пользователи не могут добавить приложение чата в пространство
Если пользователи сталкиваются с сообщением об ошибке This organization's administrator must allow users to install this Chat app при попытке добавить приложение чата в пространство, эта ошибка может быть вызвана одной из следующих причин:
- Организация отключила приложения чата.
- Организация не добавила это конкретное приложение 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 и запросы Google Chat API .
Устранение ошибок облачных функций
Если приложение чата реализовано с помощью Cloud Functions и не работает, следующие разделы помогут выявить и устранить неполадку.
Проверьте журналы облачных функций
В качестве первого шага проверьте журналы Cloud Functions на наличие ошибок.
В консоли Google Cloud перейдите на страницу Cloud Functions:
Чтобы открыть журналы, найдите функцию облака в приложении чата, затем нажмите Показать действия > Просмотреть журналы .
Открывается Logs Explorer и запускает запрос, показывающий журналы Cloud Function, включая ошибки.
Если регистрируемой по умолчанию информации недостаточно для отладки приложения, вы можете добавить дополнительную запись в журнал из кода облачной функции. См. раздел Просмотр и запись журналов облачной функции .
Проверьте ошибки функции облака
Помимо журналов, 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 . Это сообщение означает, что другая облачная функция имеет то же имя, что и развертываемая. Измените имя и разверните функцию повторно. Убедитесь, что приложение 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 ограничен доменом. Подробнее об ограничениях домена см. в статье «Ограничение идентификаторов по домену» .
Чтобы решить эту проблему, убедитесь, что ваша облачная функция допускает вызовы без аутентификации. Чтобы узнать, как разрешить вызовы без аутентификации для существующей облачной функции, см. раздел «Разрешение публичного (неаутентифицированного) доступа» .
,В этом разделе описываются распространенные проблемы, с которыми вы можете столкнуться при создании и тестировании приложений чата.
Предварительный просмотр сообщения, диалогового окна или ссылки не отображается или не работает должным образом.
Информацию об устранении неполадок с картами см. в разделе Устранение неполадок и исправление ошибок карт .
Приложение не отвечает
Если вы отправляете сообщение в приложение Chat и оно отвечает: «Приложение не отвечает», проверьте конфигурацию приложения Chat:
В консоли Google Cloud выберите Меню Дополнительные продукты > Google Workspace > Библиотека продуктов > Google Chat API > Управление > Конфигурация .
В разделе «Статус приложения» убедитесь, что выбрано значение «Доступно пользователям» .
В разделе «Интерактивные функции» убедитесь, что настройки соответствуют функционалу вашего приложения. Если ваше приложение чата взаимодействует с пользователями, убедитесь, что включена опция «Включить интерактивные функции» :
- По умолчанию приложения могут отвечать на прямые сообщения пользователей.
- Если ваше приложение отвечает на сообщения в пространствах и групповых чатах, выберите Присоединяйтесь к пространствам и групповым беседам .
- В разделе «Настройки подключения» убедитесь, что 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, используемая для настройки API Chat, не принадлежит организации Google Workspace. Для создания приложения Chat или использования API Chat необходимо использовать учётную запись Google Workspace .
Обратите внимание, что пользователи Google Chat могут использовать приложения Chat без учётной записи Google Workspace. Подробнее о том, как пользователи находят и устанавливают приложения Chat, см. в статье «Создание интерактивных приложений Google Chat» .
Пользователи могут быть исключены из пространств
Если администратор Google Workspace запрещает пользователям включать и выключать историю чата , то могут возникнуть ситуации, когда пользователи не смогут присоединиться к пространству или оставаться в нем из-за конфликта между настройкой уровня пользователя, которая принудительно включает или выключает историю чата, и пространством, которое наследует принудительную настройку уровня организации.
Например, если у пользователя принудительно включена настройка истории чата, а в чат-группе принудительно выключена настройка истории чата, то этот пользователь может не присоединиться к чат-группе. Кроме того, этот пользователь может быть удалён из чат-группы, если он присоединился до конфликта, а затем опубликовал сообщение в чат-группе после него.
В этом сценарии и других сценариях, где возникают конфликты между настройками истории, API чата может не иметь возможности создать членство, или создание сообщения с аутентификацией пользователя может привести к удалению аутентифицированного пользователя с конфликтующей настройкой истории чата из пространства.
Дополнительную информацию см. в статье «Пользователи могут быть исключены из пространств» в справочном центре администратора Google Workspace.
Устранение неполадок службы расширенного чата в скрипте Google Apps
Подробнее о службе расширенного чата см. на странице «Скрипт приложений».
Пользователи не могут добавить приложение чата в пространство
Если пользователи сталкиваются с сообщением об ошибке This organization's administrator must allow users to install this Chat app при попытке добавить приложение чата в пространство, эта ошибка может быть вызвана одной из следующих причин:
- Организация отключила приложения чата.
- Организация не добавила это конкретное приложение 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 и запросы Google Chat API .
Устранение ошибок облачных функций
Если приложение чата реализовано с помощью Cloud Functions и не работает, следующие разделы помогут выявить и устранить неполадку.
Проверьте журналы облачных функций
В качестве первого шага проверьте журналы Cloud Functions на наличие ошибок.
В консоли Google Cloud перейдите на страницу Cloud Functions:
Чтобы открыть журналы, найдите функцию облака в приложении чата, затем нажмите Показать действия > Просмотреть журналы .
Открывается Logs Explorer и запускает запрос, показывающий журналы Cloud Function, включая ошибки.
Если регистрируемой по умолчанию информации недостаточно для отладки приложения, вы можете добавить дополнительную запись в журнал из кода облачной функции. См. раздел Просмотр и запись журналов облачной функции .
Проверьте ошибки функции облака
Помимо журналов, 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 . Это сообщение означает, что другая облачная функция имеет то же имя, что и развертываемая. Измените имя и разверните функцию повторно. Убедитесь, что приложение 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 ограничен доменом. Подробнее об ограничениях домена см. в статье «Ограничение идентификаторов по домену» .
Чтобы решить эту проблему, убедитесь, что ваша облачная функция допускает вызовы без аутентификации. Чтобы узнать, как разрешить вызовы без аутентификации для существующей облачной функции, см. раздел «Разрешение публичного (неаутентифицированного) доступа» .