本指南介绍了如何使用 Google Chat API 的 SectionItem 资源中的 move 方法将项目(例如聊天室)从一个部分移到另一个部分。
如需了解详情,请参阅在 Google Chat 中创建和整理版块。
前提条件
Python
- 拥有可访问 Google Chat 的 Google Workspace 商务版或企业版账号。
- 设置环境:
- 创建 Google Cloud 项目。
- 配置 OAuth 权限请求页面。
- 启用并配置 Google Chat API,为您的 Chat 应用指定名称、图标和说明。
- 安装 Python Cloud 客户端库。
- 为桌面应用
创建 OAuth 客户端 ID 凭据。如需运行本指南中的示例,请将凭据保存为名为
credentials.json的 JSON 文件,并将其保存到本地目录中。
- 选择支持用户身份验证的授权范围。
将聊天室移至其他版块
如需将空间移至具有用户身份验证的其他部分,请在请求中传递以下内容:
- 指定
chat.users.sections授权范围。 - 调用
MoveSectionItem方法。 - 在请求正文中,指定要移动的版块项目的
name和targetSection:- 将
name设置为版块项的资源名称(例如users/me/sections/default-spaces/items/spaces/123456)。 - 将
targetSection设置为要将相应内容项移至的部分的资源名称。
- 将
以下示例将空间移至其他部分:
Python
from google.cloud import chat_v1
def move_section_item():
# Create a client
client = chat_v1.ChatServiceClient()
# Initialize request
request = chat_v1.MoveSectionItemRequest(
name="SECTION_ITEM_NAME",
target_section="TARGET_SECTION_NAME"
)
# Make the request
response = client.move_section_item(request=request)
print(response)
如需运行此示例,请替换以下内容:
SECTION_ITEM_NAME:版块项目的资源名称。TARGET_SECTION_NAME:目标部分的资源名称。
Chat API 会返回更新后的 SectionItem 实例。