Google Workspace 組織の Google Chat スペースを検索、管理する

Python

• Google Chat へのアクセス権を持つ Business または Enterprise の Google Workspace アカウント。

• 環境を設定します。
  • Google Cloud プロジェクトを作成します。
  • OAuth 同意画面を構成する。
  • Chat 用アプリの名前、アイコン、説明を使用して、Google Chat API を有効にして構成します。
  • Python Google API クライアント ライブラリをインストールします。
  • デスクトップ アプリケーションの OAuth クライアント ID 認証情報を作成します。このガイドのサンプルを実行するには、認証情報を credentials.json という名前の JSON ファイルとしてローカル ディレクトリに保存します。
• ユーザー認証をサポートする 認可スコープを選択します。

• Google Workspace 組織の Chat とスペースの会話の管理 管理者権限が必要です。

Python

1. 作業ディレクトリに search_spaces_for_hello_world.py という名前のファイルを作成します。

2. search_spaces_for_hello_world.py に次のコードを含めます。

   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient.discovery import build
   
   SCOPES = [
     'https://www.googleapis.com/auth/chat.admin.spaces.readonly',
   ]
   
   def main():
   # Authenticate with Google Workspace
   # and get user authorization.
   flow = InstalledAppFlow.from_client_secrets_file(
       'credentials.json',
       SCOPES,
   )
   creds = flow.run_local_server()
   
   # Build a service endpoint for Chat API.
   chat = build('chat', 'v1', credentials=creds)
   
   spaces = []
   page_token = ''
   
   # Search for all spaces.
   while True:
     result = (
         chat.spaces()
         .search(
             useAdminAccess=True,
             query=(
               'customer = "customers/my_customer"'
               'AND spaceType = "SPACE"'
               'AND displayName:"Hello World"'
               )
   pageToken=page_token,
         )
         .execute()
     )
     if 'spaces' not in result:
       print('No spaces found named Hello World.')
       return
     spaces.extend(result['spaces'])
     if 'nextPageToken' in result:
       page_token = result['nextPageToken']
     else:
       break
   
   print(str(len(spaces)) + ' spaces found:')
   # Prints the list of spaces.
   print(spaces)
   

3. 作業ディレクトリで、サンプルをビルドして実行します。

   python3 search_spaces_for_hello_world.py

Python

1. 作業ディレクトリに find_and_delete_inactive_spaces.py という名前のファイルを作成します。

2. find_and_delete_inactive_spaces.py に次のコードを含めます。

   
   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient.discovery import build
   
   SCOPES = [
       'https://www.googleapis.com/auth/chat.admin.spaces.readonly',
       'https://www.googleapis.com/auth/chat.admin.delete',
   ]
   
   # Any spaces that have not been active since this time will be deleted.
   INACTIVE_SPACE_DEADLINE = '"INACTIVE_DATE"'
   
   def main():
     # Authenticate with Google Workspace
     # and get user authorization.
     flow = InstalledAppFlow.from_client_secrets_file(
         'credentials.json',
         SCOPES,
     )
     creds = flow.run_local_server()
   
     # Build a service endpoint for Chat API.
     chat = build('chat', 'v1', credentials=creds)
   
     spaces = []
     page_token = ''
   
     # Search for all inactive spaces.
     while True:
       result = (
           chat.spaces()
           .search(
               useAdminAccess=True,
               query=(
                   'customer = "customers/my_customer" AND spaceType = "SPACE" AND'
                   ' lastActiveTime < '
               )
               + INACTIVE_SPACE_DEADLINE,
               pageToken=page_token,
           )
           .execute()
       )
       if 'spaces' not in result:
         print('No inactive spaces found.')
         return
       spaces.extend(result['spaces'])
       if 'nextPageToken' in result:
         page_token = result['nextPageToken']
       else:
         break
   
     print(str(len(spaces)) + ' inactive spaces found:')
     # Prints the list of inactive spaces.
     print(spaces)
   
     # Delete all inactive spaces.
     for space in spaces:
       (
           chat.spaces()
           .delete(
               useAdminAccess=True,
               name=space['name'],
           )
           .execute()
       )
       print(
           'Deleted space: '
           + space['displayName']
           + ', Resource Name: '
           + space['name']
       )
   
   if __name__ == '__main__':
     main()
   

3. コードで、INACTIVE_DATE を YYYY-MM-DDTHH:MM:SS+HH:MM 形式の日付と時刻に置き換えます。たとえば、「2024-06-01T00:00:00+00:00」などです。

4. 作業ディレクトリで、サンプルをビルドして実行します。

   python3 find_and_delete_inactive_spaces.py