Sprawdzanie szczegółów subskrypcji użytkownika lub aplikacji Google Chat

Z tego przewodnika dowiesz się, jak używać metody get w zasobie membership interfejsu Google Chat API, aby uzyskać szczegółowe informacje o członkostwie użytkownika lub aplikacji Google Chat w pokoju.

Zasób Membership wskazuje, czy użytkownik lub aplikacja Google Chat są zaproszone do pokoju, które jest jego częścią lub poza nim.

Uwierzytelnianie za pomocą uwierzytelniania aplikacji umożliwia aplikacji Google Chat dostęp do subskrypcji z pokoi, do których ma dostęp w Google Chat (np. z pokoi, do których należy), ale wyklucza subskrypcje aplikacji Google Chat, w tym własne. Uwierzytelnianie z wykorzystaniem uwierzytelniania użytkowników zwraca informacje o członkostwach z pokoi, do których ma dostęp uwierzytelniony użytkownik.

Wymagania wstępne

Python

  • Python 3.6 lub nowszy
  • Narzędzie do zarządzania pakietami pip

  • Najnowsze biblioteki klienta Google dla języka Python. Aby je zainstalować lub zaktualizować, uruchom w interfejsie wiersza poleceń to polecenie:

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
  • Projekt Google Cloud z włączonym i skonfigurowanym interfejsem Google Chat API. Instrukcje znajdziesz w artykule Tworzenie aplikacji Google Chat.

  • Skonfigurowano autoryzację dla aplikacji Google Chat. Subskrypcja obsługuje obie te metody uwierzytelniania:

Sprawdzanie szczegółów subskrypcji użytkownika lub aplikacji Google Chat

Aby uzyskać szczegółowe informacje o subskrypcji w Google Chat, podaj w prośbie:

  • W przypadku uwierzytelniania aplikacji określ zakres autoryzacji chat.bot. W przypadku uwierzytelniania użytkownika określ zakres autoryzacji chat.memberships.readonly lub chat.memberships. Sprawdzoną metodą jest wybranie najbardziej restrykcyjnego zakresu, który nadal umożliwia działanie aplikacji.
  • Wywołaj metodę get w zasobie membership.
  • Aby otrzymać nagrodę, musisz przejść name subskrypcji. Pobierz nazwę subskrypcji z zasobu członkostwa w Google Chat.

Aby zacząć korzystać z uwierzytelniania użytkowników:

Python

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

  2. Umieść ten kod w elemencie chat_membership_get.py:

    from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.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.memberships.readonly"]

def main():
    '''
    Authenticates with Chat API via user credentials,
    then gets details about a specified membership.
    '''

    # Authenticate with Google Workspace
    # and get user authorization.
    flow = InstalledAppFlow.from_client_secrets_file(
                'client_secrets.json', SCOPES)
    creds = flow.run_local_server()

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

        # The membership to get.
        #
        # 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.
        name='spaces/SPACE/members/MEMBER'

    ).execute()

    # Prints details about the created membership.
    print(result)

if __name__ == '__main__':
    main()

  3. Zastąp w nim ten fragment kodu:

    • SPACE: nazwa pokoju, którą yoßu może uzyskać za pomocą metody spaces.list w interfejsie Chat API lub z adresu URL pokoju.
    • MEMBER: nazwa subskrypcji, którą można uzyskać za pomocą metody spaces.members.list w interfejsie Chat API.

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

    python3 chat_membership_get.py

Interfejs Chat API zwraca instancję membership ze szczegółami określonego członkostwa.