Google Workspace サブスクリプションを一覧表示する

Apps Script

• Google Workspace サブスクリプション。作成するには、定期購入を作成するをご覧ください。

• 1 つ以上のサブスクリプションのすべてのイベントタイプをサポートするスコープでユーザー認証が必要です。

• Apps Script プロジェクト:
  • Apps Script によって自動的に作成されるデフォルトのプロジェクトではなく、Google Cloud プロジェクトを使用します。
  • OAuth 同意画面の構成に追加したスコープは、Apps Script プロジェクトの appsscript.json ファイルにも追加する必要があります。次に例を示します。

  "oauthScopes": [
    "https://www.googleapis.com/auth/chat.messages.readonly"
  ]
      

  • Google Workspace Events アドバンスト サービスを有効にする。

Python

• Python 3.6 以降
• pip パッケージ管理ツール
• 最新の Python 用 Google クライアント ライブラリ。これらをインストールまたは更新するには、コマンドライン インターフェースで次のコマンドを実行します。

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
    

• Google Workspace サブスクリプション。作成するには、定期購入を作成するをご覧ください。

• 認証が必要です。

  • ユーザー認証には、サブスクリプションのイベントタイプの少なくとも 1 つをサポートするスコープが必要です。スコープを特定するには、イベントタイプ別のスコープをご覧ください。
  • アプリの認証には chat.bot スコープが必要です（Google Chat アプリのみ）。

Apps Script

1. Apps Script プロジェクトで、listSubscriptions という名前の新しいスクリプト ファイルを作成し、次のコードを追加します。

   function listSubscriptions() {
     // Filter for event type (required).
     const eventType = 'EVENT_TYPE';
   
     // Filter for target resource (optional).
     const targetResource = 'TARGET_RESOURCE';
   
     const filter = `event_types:"${eventType}" AND target_resource="${targetResource}"`
   
     // Call the Workspace Events API using the advanced service.
     const response = WorkspaceEvents.Subscriptions.list({ filter });
     console.log(response);
   }
   

   次のように置き換えます。

   • EVENT_TYPE: CloudEvents 仕様に従ってフォーマットされたイベントタイプ。たとえば、Google Chat スペースへの新規メンバーシップに関するイベントを受信するサブスクリプションをフィルタするには、google.workspace.chat.message.v1.created を使用します。
   • TARGET_RESOURCE: ターゲット リソース（完全なリソース名の形式）。たとえば、Google Chat スペースの定期購入でフィルタするには、//chat.googleapis.com/spaces/SPACE_ID を使用します。ここで、spaces/SPACE_ID は Space リソースの name フィールドを表します。

2. サブスクリプションを一覧表示するには、Apps Script プロジェクトで関数 listSubscriptions を実行します。

Python

1. 作業ディレクトリに list_subscriptions.py という名前のファイルを作成し、次のコードを追加します。

   """List subscriptions."""
   
   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient.discovery import build
   
   # Specify required scopes.
   SCOPES = ['SCOPE']
   
   # Authenticate with Google Workspace and get user authentication.
   flow = InstalledAppFlow.from_client_secrets_file('client_secrets.json', SCOPES)
   CREDENTIALS = flow.run_local_server()
   
   # Call the Workspace Events API using the service endpoint.
   service = build(
       'workspaceevents',
       'v1',
       credentials=CREDENTIALS,
   )
   
   # Filter for event type (required).
   EVENT_TYPE = 'EVENT_TYPE'
   
   # Filter for target resource (optional).
   TARGET_RESOURCE = 'TARGET_RESOURCE'
   
   FILTER = f'event_types:"{EVENT_TYPE}" AND target_resource="{TARGET_RESOURCE}"'
   response = service.subscriptions().list(filter=FILTER).execute()
   print(response)
   

   次のように置き換えます。

   • SCOPE: サブスクリプションのイベントタイプを 1 つ以上サポートする OAuth スコープ。たとえば、サブスクリプションが更新された Chat スペースのイベントを受信した場合は、https://www.googleapis.com/auth/chat.spaces.readonly です。
   • EVENT_TYPE: CloudEvents 仕様に従ってフォーマットされたイベントタイプ。たとえば、Google Chat スペースの新しいメンバーシップに関するイベントを受信するサブスクリプションをフィルタするには、google.workspace.chat.message.v1.created を使用します。
   • TARGET_RESOURCE: ターゲット リソース。完全なリソース名の形式で指定します。たとえば、Google Chat スペースの定期購入でフィルタするには、//chat.googleapis.com/spaces/SPACE_ID を使用します。ここで、spaces/SPACE_ID は Space リソースの name フィールドを表します。

2. 作業ディレクトリで、OAuth クライアント ID 認証情報を保存し、ファイル名を client_secrets.json にします。コードサンプルでは、この JSON ファイルを使用して Google Workspace で認証し、ユーザー認証情報を取得します。手順については、OAuth クライアント ID の認証情報を作成するをご覧ください。

3. サブスクリプションを一覧表示するには、ターミナルで次のコマンドを実行します。

   python3 list_subscriptions.py