Usuwanie osoby z pokoju

Z tego przewodnika dowiesz się, jak używać metody delete() w zasobie Membership interfejsu Google Chat API, aby usuwać użytkowników z pokoju, czyli usuwać członkostwo. Menedżerów pokoju nie można usunąć, jeśli są jedynymi menedżerami w pokoju. Zanim usuniesz te członkostwa, przypisz innego użytkownika jako menedżera pokoju.

Jeśli jesteś administratorem Google Workspace, możesz usuwać użytkowników, grupy Google lub aplikacje Google Chat z dowolnego pokoju w organizacji Google Workspace.

MembershipZasób określa, czy użytkownik lub aplikacja Google Chat jest zaproszony do pokoju, należy do niego czy nie.

Wymagania wstępne

Node.js

Usuwanie osoby z pokoju przez użytkownika

Aby usunąć użytkownika, grupę Google lub aplikację do obsługi czatu z pokoju z uwierzytelnianiem użytkownika, w żądaniu przekaż te informacje:

  • Określ zakres autoryzacji chat.memberships. Użytkownik, który autoryzuje działanie, musi mieć uprawnienia do usunięcia użytkownika lub grupy dyskusyjnej Google z pokoju. Aby usunąć aplikację do obsługi czatu, określ chat.memberships.app zakres autoryzacji (aplikacje mogą usuwać tylko swoje członkostwo, a nie członkostwo innych aplikacji). Zalecamy wybranie najbardziej ograniczonego zakresu, który nadal umożliwia działanie aplikacji.
  • Wywołaj metodę DeleteMembership().
  • Przekaż name subskrypcji do usunięcia. Jeśli członkostwo należy do jedynego menedżera pokoju, przed usunięciem tego członkostwa przypisz innego użytkownika jako menedżera pokoju.

Aby usunąć subskrypcję z uwierzytelnianiem użytkownika:

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 te elementy:

  • SPACE_NAME: identyfikator z name pokoju. Możesz go uzyskać, wywołując metodę ListSpaces() lub z adresu URL pokoju.
  • MEMBER_NAME: identyfikator z karty uczestnika name. Identyfikator możesz uzyskać, wywołując metodę ListMemberships().

Jeśli operacja się uda, treść odpowiedzi zwróci informacje o członkostwie z wartością 'state': 'NOT_A_MEMBER', co oznacza, że użytkownik nie jest już członkiem przestrzeni.

{
    "name": "spaces/SPACE_NAME/members/MEMBER_NAME",
    "state": "NOT_A_MEMBER"
}

Usuwanie użytkownika z pokoju za pomocą aplikacji do Google Chat

Uwierzytelnianie aplikacji wymaga jednorazowego zatwierdzenia przez administratora.

Aby usunąć użytkownika, grupę Google lub aplikację do obsługi czatu z przestrzeni z uwierzytelnianiem aplikacji, w żądaniu przekaż te informacje:

  • Określ chat.app.membershipszakres autoryzacji. Usuwanie członkostwa menedżera pokoju jest obsługiwane tylko w przypadku pokoi utworzonych przez aplikacje do obsługi czatu.
  • Wywołaj metodę delete w membershipzasobie.
  • Przekaż name subskrypcji do usunięcia. Jeśli członkostwo należy do jedynego menedżera pokoju, przed usunięciem tego członkostwa przypisz innego użytkownika jako menedżera pokoju.

Napisz skrypt, który wywołuje Chat API

Aby usunąć subskrypcję za pomocą uwierzytelniania w aplikacji:

Python

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

  2. Dodaj do pliku chat_membership_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.memberships"]

def main():
    '''
    Authenticates with Chat API using app authentication,
    then deletes the specified membership.
    '''

    # 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().members().delete(

        # The membership 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.
        #
        # Replace MEMBER with a membership name.
        # Obtain the membership name from the memberships resource of
        # Chat API. To delete a Chat app's membership, replace MEMBER
        # with app; an alias for the app calling the API.
        name='spaces/SPACE/members/MEMBER'

    ).execute()

    # Print Chat API's response in your command line interface.
    # When deleting a membership, the response body is empty.
    print(result)

if __name__ == '__main__':
    main()

  3. W kodzie zastąp te elementy:

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

    • MEMBER: nazwa członkostwa, którą możesz uzyskać za pomocą spaces.members.list metody w Chat API. Aby usunąć subskrypcję aplikacji, zastąp MEMBER kodem app.

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

    python3 chat_membership_delete_app.py

Jeśli operacja się uda, treść odpowiedzi zwróci informacje o członkostwie z wartością 'state': 'NOT_A_MEMBER', co oznacza, że użytkownik nie jest już członkiem przestrzeni.

{
    "name": "spaces/SPACE/members/MEMBER",
    "state": "NOT_A_MEMBER"
}

Usuwanie użytkowników lub grup Google z pokoju jako administrator Google Workspace

Jeśli jesteś administratorem Google Workspace, możesz wywołać metodę DeleteMembership(), aby usunąć użytkowników, grupy Google lub aplikacje Google Chat z dowolnego pokoju w organizacji Google Workspace.

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

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

Ograniczenia i kwestie do rozważenia

  • W przypadku uwierzytelniania aplikacji aplikacja Google Chat może usuwać użytkowników, ale nie grupy Google ani aplikacje Google Chat.