Obtén detalles sobre una membresía

En esta guía, se explica cómo usar el método get en el recurso membership de la API de Google Chat para obtener detalles sobre la membresía de un espacio.

El Recurso Membership representa si se invita a un usuario humano o a una app de Google Chat es parte de un espacio o está ausente.

Autentica con autenticación de apps permite que una app de Chat obtenga membresías de los espacios que tiene acceso en Google Chat (por ejemplo, en los espacios de los que es miembro), pero excluye Membresías de la app de Chat, incluida la propia Autenticación con autenticación de usuarios devuelve membresías de espacios a los que tiene acceso el usuario autenticado.

Requisitos previos

Python

  • Python 3.6 o superior
  • La herramienta de administración de paquetes pip
  • Las bibliotecas cliente de Google más recientes. Para instalarlas o actualizarlas, Ejecuta el siguiente comando en tu interfaz de línea de comandos: 
    pip3 install --upgrade google-api-python-client google-auth-oauthlib

Obtén detalles sobre una membresía

Para obtener detalles sobre una membresía de Google Chat, pasa lo siguiente en tu solicitud:

  • Con autenticación de app, especifica el permiso de autorización chat.bot. Con autenticación de usuarios, especifica la autorización chat.memberships.readonly o chat.memberships del proyecto. Como práctica recomendada, elige el alcance más restrictivo que aún permite que tu app funcione.
  • Llama al Método get en la Recurso membership.
  • Aprueba el name de la membresía para obtenerla. Obtén el nombre de la membresía de la recurso de membresía de Google Chat.

Aquí te mostramos cómo obtener una membresía con Autenticación de usuarios:

Python

  1. En el directorio de trabajo, crea un archivo llamado chat_membership_get.py.

  2. Incluye el siguiente código en 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. En el código, reemplaza lo siguiente:

    • SPACE: Es un nombre de espacio, que puedes obtener desde Método spaces.list en la API de Chat o desde la URL de un espacio.
    • MEMBER: Es un nombre de membresía que puedes obtener. de la Método spaces.members.list en la API de Chat.

  4. En tu directorio de trabajo, compila y ejecuta la muestra:

    python3 chat_membership_get.py

La API de Chat devuelve una instancia de membership en los que se detalle la membresía especificada.