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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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 セクション リストの末尾。