Usuwanie pokoju

Z tego przewodnika dowiesz się, jak za pomocą metody delete() w zasobie Space interfejsu Google Chat API usunąć nazwany pokój, gdy nie jest już potrzebny. Usunięcie pokoju powoduje też usunięcie wszystkich jego elementów, w tym wiadomości i załączników.

Jeśli jesteś administratorem Google Workspace, możesz wywołać metodę delete(), aby usunąć dowolny nazwany pokój w organizacji Google Workspace.

Zasób Space reprezentuje miejsce, w którym użytkownicy i aplikacje Google Chat mogą wysyłać wiadomości, udostępniać pliki i współpracować. Istnieje kilka rodzajów pokoi:

  • Czaty to rozmowy między 2 użytkownikami lub użytkownikiem a aplikacją Google Chat.
  • Czaty grupowe to rozmowy między co najmniej 3 użytkownikami i aplikacjami Google Chat.
  • Nazwane pokoje to trwałe miejsca, w których użytkownicy mogą wysyłać wiadomości, udostępniać pliki i współpracować.

Wymagania wstępne

Node.js

Usuwanie nazwanego pokoju przez użytkownika

Aby usunąć istniejący pokój w Google Chat za pomocą uwierzytelniania użytkownika, w żądaniu podaj te informacje:

  • Określ zakres autoryzacji chat.delete.
  • Wywołaj DeleteSpace() metodę.
  • Przekaż name pokoju, który chcesz usunąć.

Oto jak usunąć pokój:

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);
}

await main();

Aby uruchomić ten przykład, zastąp SPACE_NAME identyfikatorem z pola name. Identyfikator możesz uzyskać, wywołując ListSpaces() metodę lub z adresu URL pokoju.

Usuwanie nazwanego pokoju przez aplikację Google Chat

Uwierzytelnianie aplikacji wymaga jednorazowego zatwierdzenia przez administratora.

W przypadku uwierzytelniania aplikacji możesz usuwać tylko pokoje utworzone przez aplikacje Google Chat.

Aby usunąć istniejący pokój w Google Chat za pomocą uwierzytelniania aplikacji, w żądaniu podaj te informacje:

  • Określ zakres autoryzacji chat.app.delete.
  • Wywołaj metodę delete w zasobie Space.
  • Przekaż name pokoju, który chcesz usunąć.

Napisz skrypt, który wywołuje interfejs Chat API

Oto jak usunąć pokój:

Python

  1. W katalogu roboczym utwórz plik o nazwie chat_space_delete_app.py.

  2. W pliku chat_space_delete_app.py umieść ten kod:

    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)

    # 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. W kodzie zastąp te elementy:

    • SPACE nazwą pokoju, którą możesz uzyskać za pomocą metody spaces.list w interfejsie Chat API lub z adresu URL pokoju.

  4. W katalogu roboczym skompiluj i uruchom przykład:

    python3 chat_space_delete_app.py

Jeśli operacja się uda, treść odpowiedzi będzie pusta, co oznacza, że pokój został usunięty.

Usuwanie nazwanego pokoju przez administratora Google Workspace

Jeśli jesteś administratorem Google Workspace, możesz wywołać metodę DeleteSpace(), aby usunąć dowolny nazwany pokój w organizacji Google Workspace.

Aby wywołać tę metodę jako administrator Google Workspace, wykonaj te czynności:

Więcej informacji i przykładów znajdziesz w artykule Zarządzanie pokojami Google Chat jako administrator Google Workspace.