このガイドでは、Google Chat API の Section リソースの
create
メソッドを使用して、Google Chat に新しい
カスタム セクションを作成する方法について説明します。
セクションを使用すると、会話をグループ化し、Google Chat ナビゲーション パネルに表示されるスペースのリストをカスタマイズできます。詳細については、 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認証スコープを指定します。CreateSectionメソッドを呼び出します。- リクエストの本文に
Sectionリソースを指定します。displayNameをセクションの名前(最大 80 文字)に設定します。typeをCUSTOM_SECTIONに設定します。
次の例では、セクションを作成します。
Python
from google.cloud import chat_v1
def create_section():
# Create a client
client = chat_v1.ChatServiceClient()
# Initialize request
request = chat_v1.CreateSectionRequest(
parent="users/me",
section=chat_v1.Section(
display_name="SECTION_DISPLAY_NAME",
type=chat_v1.Section.SectionType.CUSTOM_SECTION
)
)
# Make the request
response = client.create_section(request=request)
print(response)
このサンプルを実行するには、次の値を置き換えます。
SECTION_DISPLAY_NAME: 新しいセクションの名前。
Chat API は、作成されたセクションの詳細を示す
Section のインスタンスを返します。