Method: users.sections.position

更改某个部分的排序顺序。如需了解详情，请参阅在 Google Chat 中创建和整理版块。

需要使用以下授权范围进行用户身份验证：

  • https://www.googleapis.com/auth/chat.users.sections

HTTP 请求

POST https://chat.googleapis.com/v1/{name=users/*/sections/*}:position

网址采用 gRPC 转码语法。

路径参数

参数
name

string

必需。要定位的部分的资源名称。

格式：users/{user}/sections/{section}

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{

  // Union field position can be only one of the following:
  "sortOrder": integer,
  "relativePosition": enum (Position)
  // End of list of possible types for union field position.
}
字段
联合字段 position。必需。相应部分的新位置。position 只能是下列其中一项：
sortOrder

integer

可选。相应版块在版块列表中的绝对位置。位置必须大于 0。如果位置大于部分数量，则相应部分将附加到列表末尾。此操作会在指定位置插入部分，并将该位置及以下位置的原始部分移至下一个位置。
relativePosition

enum (Position)

可选。相应版块在版块列表中的相对位置。

响应正文

用于定位版块的响应消息。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "section": {
    object (Section)
  }
}
字段
section

object (Section)

更新后的部分。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/chat.users.sections

如需了解详情，请参阅授权指南。

位置

相应部分的位置。

枚举
POSITION_UNSPECIFIED 未指定位置。
START 版块列表的开头。
END 版块列表结束。