Cómo buscar un espacio de mensaje directo (MD)

En esta guía, se explica cómo usar el método findDirectMessage en el recurso Space de la API de Google Chat para obtener detalles sobre un espacio de mensajes directos (MD).

El recurso Space representa un lugar en el que las personas y las apps de chat pueden enviar mensajes, compartir archivos y colaborar. Existen varios tipos de espacios:

  • Los mensajes directos (MD) son conversaciones entre dos usuarios o un usuario y una app de Chat.
  • Los chats en grupo son conversaciones entre tres o más usuarios y las apps de chat.
  • Los espacios con nombre son lugares persistentes en los que las personas envían mensajes, comparten archivos y colaboran.

La autenticación con la autenticación de la app permite que una app de Chat reciba MD a los que tiene acceso en Google Chat (por ejemplo, los MD a los que pertenece). La autenticación con autenticación de usuario muestra los MD 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 Python. Para instalarlos o actualizarlos, ejecuta el siguiente comando en la interfaz de línea de comandos:

    pip3 install --upgrade google-api-python-client google-auth-httplib2 google-auth-oauthlib oauth2client

  • Una app de Chat publicada. Para crear y publicar una app de Chat, consulta Cómo compilar una app de Google Chat.

  • Autorización configurada para la app de Chat. La búsqueda de un mensaje directo admite lo siguiente:

Buscar un mensaje directo

Para encontrar un mensaje directo en Google Chat, pasa lo siguiente en tu solicitud:

  • Con la autenticación de la app, especifica el alcance de autorización chat.bot. Con la autenticación de usuario, especifica el alcance de la autorización chat.spaces.readonly o chat.spaces.
  • Llama al método findDirectMessage en el recurso User y pasa el name del otro usuario en el DM para mostrarlo. Con la autenticación de usuario, este método muestra un MD entre el usuario que realiza la llamada y el usuario especificado. Con la autenticación de la app, este método muestra un MD entre la app que realiza la llamada y el usuario especificado.
  • Para agregar un usuario humano como miembro del espacio, especifica users/{user}, en el que {user} es el {person_id} de person de la API de People o el ID de un user en la API de Directory. Por ejemplo, si la persona resourceName de la API de People es people/123456789, puedes agregar al usuario al espacio si incluyes una membresía con users/123456789 como member.name.

Busca un mensaje directo con autenticación de usuario

A continuación, te indicamos cómo encontrar un mensaje directo con la autenticación de usuarios:

Python

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

  2. Incluye el siguiente código en chat_space_find_dm_user.py:

    import os.path

from google.auth.transport.requests import Request
from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError

# 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.spaces.readonly"]

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

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

          # The other user in the direct message (DM) to return.
          #
          # Replace USER with a user name.
          name='users/USER'

      ).execute()

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

if __name__ == '__main__':
    main()

  3. En el código, reemplaza USER por el name de un User en Google Chat.

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

    python3 chat_space_find_dm_user.py

La API de Chat muestra una instancia de Space en la que se detalla el DM especificado.

Cómo buscar un mensaje directo con la autenticación de la app

Para encontrar un mensaje directo con la autenticación de la app, sigue estos pasos:

Python

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

  2. Incluye el siguiente código en chat_space_find_dm_app.py:

    from httplib2 import Http
from oauth2client.service_account import ServiceAccountCredentials
from apiclient.discovery import build

# Specify required scopes.
SCOPES = ['https://www.googleapis.com/auth/chat.bot']

# Specify service account details.
CREDENTIALS = ServiceAccountCredentials.from_json_keyfile_name(
    'credentials.json', SCOPES)

# Build the URI and authenticate with the service account.
chat = build('chat', 'v1', http=CREDENTIALS.authorize(Http()))

# Use the service endpoint to call Chat API.
result = chat.spaces().findDirectMessage(

    # The other user in the direct message (DM) to return.
    #
    # Replace USER with a user name.
    name='users/USER'

).execute()

print(result)

  3. En el código, reemplaza USER por el name de un User en Google Chat.

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

    python3 chat_space_find_dm_app.py

La API de Chat muestra una instancia de Space en la que se detalla el DM especificado.