本指南介绍了如何使用
move
方法将项(例如聊天室)从 Google Chat API 的 SectionItem 资源中的一个部分移动到另一个部分。
如需了解详情,请参阅 在 Google Chat 中创建和整理部分。
前提条件
Python
- 拥有可访问 Google Chat的 Google Workspace商务版或企业版账号。
- 设置环境:
- 创建 Google Cloud 项目。
- 配置 OAuth 权限请求页面。
- 为 Chat 应用启用并配置 Google Chat API,并为其指定名称、 图标和说明。
- 安装 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的更新实例。