Obtenir des informations sur un abonnement

Ce guide explique comment utiliser la méthode get sur la ressource membership. de l'API Google Chat pour obtenir des informations sur une adhésion à un espace.

La Ressource Membership indique si un utilisateur humain ou une application Google Chat est invité, est inclus ou absent d'un espace.

Authentification avec authentification des applications permet à une application Chat de recevoir des membres des espaces dont elle dispose dans Google Chat (par exemple, les espaces dont il est membre), mais exclut Abonnements aux applications de chat, y compris les siens. Authentification... avec authentification utilisateur renvoie les adhésions à partir des espaces auxquels l'utilisateur authentifié a accès.

Prérequis

Python

  • Python 3.6 ou version ultérieure
  • L'outil de gestion de packages pip
  • Les dernières bibliothèques clientes Google Pour les installer ou les mettre à jour, exécutez la commande suivante dans votre interface de ligne de commande: 
    pip3 install --upgrade google-api-python-client google-auth-oauthlib

Obtenir des informations sur un abonnement

Pour en savoir plus sur une souscription à Google Chat, transmettez ce qui suit dans votre requête:

  • Avec authentification de l'application, spécifiez le champ d'application de l'autorisation chat.bot. Avec authentification des utilisateurs, spécifiez l'autorisation chat.memberships.readonly ou chat.memberships le champ d'application. Nous vous recommandons de choisir le champ d'application le plus restrictif permet à votre application de fonctionner.
  • Appelez la méthode Méthode get le Ressource membership.
  • Transmettez l'name de l'abonnement. Obtenez le nom de l'adhésion à partir de la ressource réservée aux membres de Google Chat.

Voici comment souscrire un abonnement avec authentification de l'utilisateur:

Python

  1. Dans votre répertoire de travail, créez un fichier nommé chat_membership_get.py.

  2. Ajoutez le code suivant dans 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 membership.
    print(result)

if __name__ == '__main__':
    main()

  3. Dans le code, remplacez les éléments suivants:

    • SPACE: nom d'espace, que vous pouvez obtenir à partir de la méthode spaces.list. dans l'API Chat ou depuis l'URL d'un espace.
    • MEMBER: nom d'appartenance, que vous pouvez obtenir à partir de Méthode spaces.members.list dans l'API Chat.

  4. Dans votre répertoire de travail, créez et exécutez l'exemple:

    python3 chat_membership_get.py

L'API Chat renvoie une instance de membership détaillant l'appartenance spécifiée.