解决错误并重新激活 Google Workspace 订阅

本页介绍了如何通过解决或排查错误并调用 subscriptions.reactivate() 方法来重新激活已暂停的 Google Workspace 订阅。

每当错误导致订阅无法接收事件时,Google Workspace 订阅都会被暂停。例如,如果找不到订阅的目标资源或通知端点,系统会暂停该订阅。解决订阅的所有错误后,您可以重新激活订阅,以便重新开始接收事件。

您可以通过以下方式了解已中止的订阅:

  • 您的应用会收到有关暂停的生命周期事件。如果您的订阅因其端点出错而被暂停,您可能不会收到生命周期事件。
  • 您可以使用 subscriptions.get()subscriptions.list() 方法查看订阅的 state 字段是否已设置为 SUSPENDED
  • 您会收到通知,告知您的通知端点递送失败。如需了解如何监控向 Google Cloud Pub/Sub 主题传送消息时发生的传送失败问题,请参阅处理消息传送失败问题

重新激活的订阅会保留原来的到期日期。如需延长订阅的到期时间,请参阅更新或续订

Apps 脚本

  • Apps 脚本项目:
    • 使用您的 Google Cloud 项目,而不是 Apps Script 自动创建的默认项目。
    • 对于您添加以配置 OAuth 同意屏幕的任何范围,您还必须将这些范围添加到 Apps Script 项目中的 appsscript.json 文件。 例如:
    • "oauthScopes": [
        "https://www.googleapis.com/auth/chat.messages.readonly"
      ]
          
    • 启用 Google Workspace Events 高级服务。

Python

  • Python 3.6 或更高版本
  • pip 软件包管理工具
  • 最新的 Python 版 Google 客户端库。如需安装或更新这些软件包,请在命令行界面中运行以下命令:
      pip3 install --upgrade google-api-python-client google-auth-oauthlib
      

找出并解决错误

如需识别订阅的错误,请查看订阅的 suspensionReason 字段。您可以在收到与暂停相关的生命周期事件时找到此字段,也可以使用 subscriptions.get() 方法查看订阅的所有字段。

下表显示了订阅可能出现的错误以及可能的解决方法。如果您无法解决此错误,可以删除订阅,或等待订阅到期。Google Workspace Events API 会自动删除已过期的订阅。

错误 说明 解决方法

USER_SCOPE_REVOKED

授权用户已撤消对订阅所需的一个或多个 OAuth 范围的授予。 获取另一个访问令牌。如需了解详情,请参阅 从 Google 授权服务器获取访问令牌

RESOURCE_DELETED

订阅的目标资源已被删除。 如果资源已恢复,请调用 reactivate() 方法。否则,您无需采取任何行动,因为您无法在没有原始目标资源的情况下重新激活订阅。

USER_AUTHORIZATION_FAILURE

授权用户无权再访问订阅的资源。 无需执行任何操作。由于授权该订阅的用户无法访问目标资源,因此您无法重新启用该订阅。

ENDPOINT_PERMISSION_DENIED

Google Workspace 应用无权向您的通知端点提交事件。 为传送事件的 Google Workspace 应用授予对服务账号的访问权限。

对于 Google Chat 事件,服务账号为 chat-api-push@system.gserviceaccount.com。对于 Google Meet 事件,服务账号为 meet-api-event-push@system.gserviceaccount.com

对于 Pub/Sub 主题,请向服务账号授予 Pub/Sub 发布商 (roles/pubsub.publisher) ) 角色。

ENDPOINT_NOT_FOUND

通知端点不存在或找不到。 检查端点是否仍处于有效状态并正常运行。如需排查 Pub/Sub 主题问题,请参阅问题排查文档

ENDPOINT_RESOURCE_EXHAUSTED

由于配额不足或达到速率限制,通知端点未能接收事件。 申请增加配额。

重新激活订阅

解决导致订阅被暂停的错误后,您可以使用 reactivate() 方法让订阅重新接收事件。该方法会检查是否已解决所有错误,并将订阅的 state 字段从 SUSPENDED 更改为 ACTIVE

如需重新激活 Google Workspace 订阅,请执行以下操作:

Apps 脚本

  1. 在 Apps 脚本项目中,创建一个名为 reactivateSubscription 的新脚本文件,并添加以下代码:

    function reactivateSubscription() {
      // The name of the subscription to reactivate.
      const name = 'subscriptions/SUBSCRIPTION_ID';
    
      // Call the Workspace Events API using the advanced service.
      const response = WorkspaceEvents.Subscriptions.reactivate({}, name);
      console.log(response);
    }
    

    替换以下内容:

    • SUBSCRIPTION_ID:订阅的 ID。如需获取 ID,您可以使用以下任一方法:
      • uid 字段的值。
      • name 字段中表示的资源名称的 ID。例如,如果资源名称为 subscriptions/subscription-123,请使用 subscription-123
  2. 如需重新激活 Google Workspace 订阅,请在 Apps 脚本项目中运行函数 reactivateSubscription

Python

  1. 在工作目录中,创建一个名为 reactivate_subscription.py 的文件,并添加以下代码:

    """Reactivate subscription."""
    
    from google_auth_oauthlib.flow import InstalledAppFlow
    from googleapiclient.discovery import build
    
    # Specify required scopes.
    SCOPES = [SCOPES]
    
    # Authenticate with Google Workspace and get user authentication.
    flow = InstalledAppFlow.from_client_secrets_file('client_secrets.json', SCOPES)
    CREDENTIALS = flow.run_local_server()
    
    # Call the Workspace Events API using the service endpoint.
    service = build(
        'workspaceevents',
        'v1',
        credentials=CREDENTIALS,
    )
    
    NAME = 'subscriptions/SUBSCRIPTION_ID'
    response = service.subscriptions().reactivate(name=NAME).execute()
    print(response)
    

    替换以下内容:

    • SCOPES:一个或多个OAuth 范围,用于支持订阅的每种事件类型。格式为字符串数组。如需列出多个镜重,请用英文逗号分隔。例如 'https://www.googleapis.com/auth/chat.spaces.readonly', 'https://www.googleapis.com/auth/chat.memberships.readonly'
    • SUBSCRIPTION_ID:订阅的 ID。如需获取 ID,您可以使用以下任一方法:
      • uid 字段的值。
      • name 字段中表示的资源名称的 ID。例如,如果资源名称为 subscriptions/subscription-123,请使用 subscription-123
  2. 在工作目录中,确保您已存储 OAuth 客户端 ID 凭据并将文件命名为 client_secrets.json。该代码示例使用此 JSON 文件通过 Google Workspace 进行身份验证并获取用户凭据。如需了解相关说明,请参阅创建 OAuth 客户端 ID 凭据

  3. 如需重新激活 Google Workspace 订阅,请在终端中运行以下命令:

    python3 reactivate_subscription.py
Google Workspace Events API 会返回一个包含 Subscription 资源实例的长时间运行的操作

如果请求失败,请参阅下一部分以排查其他错误。

排查多个错误

如果您已解决导致订阅被暂停的错误,但 reactivate() 方法仍会失败,则说明订阅被暂停后可能发生了另一个错误。

如需识别其他错误,请查看失败请求的输出。输出包含仍存在的所有错误。

如果您的订阅存在多个错误,suspensionReason 字段的值始终使用导致您的订阅被暂停的原始错误。