スペースを削除する

このガイドでは、 delete() メソッドを Space リソースで使用すると、 防ぐことができます。スペースを削除すると、そのスペース内のすべてのスペースも メッセージと添付ファイルも含まれます。

Google Workspace 管理者の方は、delete() にご連絡ください メソッドを使用して、Google Workspace 組織内の名前付きスペースを削除できます。

Space リソースは、ユーザーや Chat アプリがメッセージを送信したり、ファイルを共有したり、コラボレーションしたりできる場所を表します。スペースには次の 2 種類があります。

  • ダイレクト メッセージ(DM)は、2 人のユーザー間、またはユーザーと Chat アプリ間の会話です。
  • グループ チャットとは、3 人以上のユーザーと Chat 用アプリ。
  • 名前付きスペースは、メッセージの送信、ファイルの共有、 考えています

前提条件

Node.js

<ph type="x-smartling-placeholder">

ユーザーとして名前付きスペースを削除する

ユーザー認証を使用して Google Chat の既存のスペースを削除するには、リクエストで次のように渡します。

  • chat.delete 認可スコープを指定します。
  • DeleteSpace() メソッドを呼び出します。
  • 削除するスペースの name を渡します。

スペースを削除する方法は次のとおりです。

Node.js

chat/client-libraries/cloud/delete-space-user-cred.js
import {createClientWithUserCredentials} from './authentication-utils.js';

const USER_AUTH_OAUTH_SCOPES = ['https://www.googleapis.com/auth/chat.delete'];

// This sample shows how to delete a space with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME here
    name: 'spaces/SPACE_NAME'
  };

  // Make the request
  const response = await chatClient.deleteSpace(request);

  // Handle the response
  console.log(response);
}

main().catch(console.error);

このサンプルを実行するには、SPACE_NAME をスペースの name フィールドの ID に置き換えます。ID を取得するには、このメソッドを呼び出して、 ListSpaces() スペースの URL から取得できます。

Chat アプリとして名前付きスペースを削除する

アプリの認証には、1 回限りの管理者の承認が必要です。

アプリ認証では、Chat アプリによって作成されたスペースのみを削除できます。

アプリ認証を使用して Google Chat の既存のスペースを削除するには、リクエストで次の情報を渡します。

API キーを作成する

Developer Preview API メソッドを呼び出すには、API ディスカバリ ドキュメントの非公開のデベロッパー プレビュー版を使用する必要があります。リクエストを認証するには、API キーを渡す必要があります。

API キーを作成するには、アプリの Google Cloud プロジェクトを開き、次の手順を行います。

  1. Google Cloud コンソールで、メニュー に移動します。 &gt; API とサービス &gt; [認証情報] をタップします。

    [認証情報] に移動

  2. [認証情報を作成] &gt; をクリックします。 API キー
  3. 新しい API キーが表示されます。
    • [コピー] をクリックして、アプリのコードで使用する API キーをコピーします。API キーは、プロジェクトの認証情報の [API キー] セクションでも確認できます。
    • 詳細設定を更新して使用を制限するには、[キーを制限] をクリックします 指定します。詳細については、API キーの制限を適用するをご覧ください。

Chat API を呼び出すスクリプトを記述する

スペースを削除する方法は次のとおりです。

Python

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

    from google.oauth2 import service_account
    from apiclient.discovery import build
    
    # Define your app's authorization scopes.
    # When modifying these scopes, delete the file token.json, if it exists.
    SCOPES = ["https://www.googleapis.com/auth/chat.app.delete"]
    
    def main():
        '''
        Authenticates with Chat API using app authentication,
        then deletes the specified space.
        '''
    
        # Specify service account details.
        creds = (
            service_account.Credentials.from_service_account_file('credentials.json')
            .with_scopes(SCOPES)
        )
    
        # Build a service endpoint for Chat API.
        chat = build('chat', 'v1', credentials=creds, discoveryServiceUrl='https://chat.googleapis.com/$discovery/rest?version=v1&labels=DEVELOPER_PREVIEW&key=API_KEY')
    
        # Use the service endpoint to call Chat API.
        result = chat.spaces().delete(
    
              # The space to delete.
              #
              # Replace SPACE with a space name.
              # Obtain the space name from the spaces resource of Chat API,
              # or from a space's URL.
              name='spaces/SPACE'
    
          ).execute()
    
        # Print Chat API's response in your command line interface.
        # When deleting a space, the response body is empty.
        print(result)
    
    if __name__ == '__main__':
        main()
    
  3. コードで、次のように置き換えます。

    • API_KEY: Chat API のサービス エンドポイントを構築するために作成した API キー。

    • SPACE は、スペース名に置き換えます。 これは spaces.list メソッド スペースの URL から取得できます。

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

    python3 chat_space_delete_app.py
    

成功した場合、レスポンスの本文は空になります。これは、スペースが 削除されました。

Google Workspace 管理者として名前付きスペースを削除する

Google Workspace 管理者は、 DeleteSpace() メソッドを使用して、スペース内の名前付きスペースを Google Workspace の組織。

Google Workspace 管理者としてこのメソッドを呼び出す手順は次のとおりです。

  • ユーザー認証を使用してメソッドを呼び出し、 認可スコープ このメソッドは、 管理者権限があることを確認します。
  • リクエストで、クエリ パラメータ useAdminAccesstrue に指定します。

詳細と例については、 Google Workspace 管理者として Google Chat スペースを管理する