このガイドでは、Google Chat API の SectionItem リソースの move メソッドを使用して、アイテム(スペースなど)をあるセクションから別のセクションに移動する方法について説明します。
詳しくは、Google Chat でセクションを作成して整理するをご覧ください。
前提条件
Python
- Google Chat へのアクセス権を持つ Business または Enterprise の 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 のインスタンスを返します。