Usuwanie pokoju

Z tego przewodnika dowiesz się, jak korzystać z delete() w zasobie Space interfejsu Google Chat API, aby usunąć nazwany pokój, gdy nie jest już potrzebna. Usunięcie pokoju spowoduje też usunięcie całej jego zawartości zawiera (w tym wiadomości i załączniki).

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

SpaceZasób to miejsce, w którym użytkownicy i aplikacje czatu mogą wysyłać wiadomości, udostępniać pliki i współpracować. Jest kilka rodzajów pokoi:

  • Czaty to rozmowy między 2 użytkownikami lub użytkownikiem aplikacji do obsługi czatu.
  • Czaty grupowe to rozmowy między co najmniej 3 użytkownikami komunikatory;
  • Nazwane pokoje to stałe miejsca, w których użytkownicy wysyłają wiadomości, udostępniają pliki i współpracują.

Wymagania wstępne

Node.js

Usuwanie nazwanego pokoju przez użytkownika

Aby usunąć istniejący pokój w Google Chat z: user authentication, zaliczaj następujące elementy w żądaniu:

  • Określ zakres autoryzacji chat.delete.
  • Wywołaj metodę DeleteSpace().
  • Aby usunąć pokój, przekaż name z pokoju.

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

main().catch(console.error);

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

Usuwanie nazwanego pokoju jako aplikacji Google Chat

Aby uwierzytelnić aplikację, musisz jednorazowo zatwierdzić ją przez administratora.

Po włączeniu uwierzytelniania aplikacji możesz usuwać tylko pokoje utworzone przez komunikatory;

Aby usunąć istniejący pokój w Google Chat z: uwierzytelnianie aplikacji, karta następujące elementy w żądaniu:

  • Określ zakres upoważnienia chat.app.delete.
  • Wywołaj metodę delete zasobu Space.
  • Aby usunąć pokój, przekaż name z pokoju.

Tworzenie klucza interfejsu API

Aby wywołać metodę interfejsu Developer Preview API, musisz użyć niepublicznej wersji przedpremierowej dla programistów dokumentu opisującego interfejs API. Aby uwierzytelnić żądanie, musisz przekazać klucz interfejsu API.

Aby utworzyć klucz interfejsu API, otwórz projekt Google Cloud aplikacji i wykonaj te czynności:

  1. W konsoli Google Cloud kliknij Menu  > Interfejsy API i usługi > Dane logowania.

    Przejdź do danych logowania

  2. Kliknij Utwórz dane logowania > Klucz interfejsu API.
  3. Wyświetli się nowy klucz API.
    • Kliknij Kopiuj . aby skopiować klucz interfejsu API i użyć go w kodzie aplikacji. Kluczem interfejsu API może być również w „kluczach interfejsu API” danych logowania do projektu.
    • Kliknij Ogranicz klucz, aby zaktualizować ustawienia zaawansowane i ograniczyć użycie klucza API. Więcej informacji znajdziesz w artykule Stosowanie ograniczeń kluczy interfejsu API.

Napisać skrypt, który wywołuje interfejs Chat API

Aby usunąć pokój:

Python

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

  2. Umieść w pliku chat_space_delete_app.py 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, 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. Zastąp w kodzie następujące elementy:

    • API_KEY: klucz interfejsu API utworzony przez Ciebie na potrzeby kompilacji. punktu końcowego usługi Chat API.

    • SPACE z nazwą pokoju, którą możesz uzyskać z metody spaces.list w interfejsie API Google Chat 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 spację Usunięto.

Usuwanie nazwanego pokoju przez administratora Google Workspace

Jeśli jesteś administratorem Google Workspace, możesz wywołać DeleteSpace(), aby usunąć nazwany obszar z organizacji Google Workspace.

Aby wywołać tę metodę jako administrator Google Workspace:

  • Wywołaj metodę, używając uwierzytelniania użytkownika, i określ zakres autoryzacji, który obsługuje wywoływanie metody przy użyciu uprawnień administratora.
  • W żądaniu określ parametr zapytania od useAdminAccess do true.

Więcej informacji i przykłady znajdziesz w artykule Zarządzanie pokojami Google Chat przez administratora Google Workspace.