Invitar o agregar a un usuario, un Grupo de Google o una app de Google Chat a un espacio (original) (raw)

En esta guía, se explica cómo usar el método create() del recurso Membership de la API de Google Chat para invitar o agregar un usuario, un Grupo de Google o una app de Chat a un espacio, lo que también se conoce como crear una membresía. Cuando se crea una membresía, si el miembro especificado tiene desactivada la política de aceptación automática, se le envía una invitación y debe aceptarla antes de unirse al espacio. De lo contrario, crear una membresía agrega al miembro directamente al espacio especificado.

Si eres administrador de Google Workspace, puedes agregar usuarios, Grupos de Google o apps de Chat a cualquier espacio de tu organización de Google Workspace.

El recursoMembership indica si un usuario humano o una app de Google Chat está invitado a un espacio, forma parte de él o no está presente en él.

Requisitos previos

Node.js

Python

Java

Apps Script

Para invitar o agregar a un usuario a un espacio con autenticación de usuario, pasa lo siguiente en tu solicitud:

En el siguiente ejemplo, se agrega un usuario a un espacio con autenticación de usuario:

Node.js

Python

Java

Apps Script

Para ejecutar la muestra, reemplaza lo siguiente:

La API de Chat devuelve una instancia de Membership que detalla la membresía del usuario que se creó.

Invita o agrega un Grupo de Google a un espacio

Para invitar o agregar un grupo de Google a un espacio con autenticación de usuarios (la autenticación de apps no admite invitar ni agregar un grupo de Google a un espacio), pasa lo siguiente en tu solicitud:

Los Grupos de Google solo se pueden agregar a un espacio con nombre, no a un chat en grupo ni a un mensaje directo.

En el siguiente ejemplo, se agrega un grupo a un espacio con nombre con autenticación del usuario:

Node.js

Python

Java

Apps Script

Para ejecutar la muestra, reemplaza lo siguiente:

La API de Chat devuelve una instancia de Membership que detalla la membresía del usuario que se creó.

Agrega una app de Chat a un espacio

Una app de Chat no puede agregar otra app como miembro a un espacio. Para agregar una app de Chat a un espacio o a un mensaje directo entre dos usuarios humanos, pasa lo siguiente en tu solicitud con autenticación de usuario (la autenticación de app no admite invitar ni agregar una app de Chat a un espacio):

En el siguiente ejemplo, se agrega una app de Chat a un espacio:

Node.js

Python

Java

Apps Script

Para ejecutar la muestra, reemplaza SPACE_NAME por el ID del name del espacio. Puedes obtener el ID llamando al método ListSpaces() o desde la URL del espacio.

La API de Chat devuelve una instancia de Membership que detalla la membresía del usuario que se creó.

Invita o agrega a un usuario a un espacio como app de Chat

La autenticación de la app requiere la aprobación del administrador por única vez.

Para invitar o agregar un usuario a un espacio con autenticación de la app, pasa lo siguiente en tu solicitud:

Escribe un script que llame a la API de Chat

En el siguiente ejemplo, se agrega un usuario a un espacio con autenticación de la app:

Python

  1. En tu directorio de trabajo, crea un archivo llamado chat_membership_app_create.py.
  2. Incluye el siguiente código en chat_membership_app_create.py:
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 adds a user to a Chat space by creating a 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().create(  
        # The space in which to create a membership.  
        parent = 'spaces/SPACE',  
        # Specify which user the membership is for.  
        body = {  
          'member': {  
            'name':'users/USER',  
            'type': 'HUMAN'  
          }  
        }  
    ).execute()  
    # Prints details about the created membership.  
    print(result)  
if __name__ == '__main__':  
    main()
  1. En el código, reemplaza lo siguiente:
    • SPACE: Es el nombre de un espacio, que puedes obtener del método spaces.list en la API de Chat o de la URL de un espacio.
    • USER: Es un ID de usuario.
  2. En tu directorio de trabajo, compila y ejecuta la muestra:
python3 chat_membership_app_create.py

Agrega usuarios o Grupos de Google a un espacio como administrador de Google Workspace

Si eres administrador de Google Workspace, puedes llamar al método create() para agregar usuarios, Grupos de Google o apps de Chat a cualquier espacio de tu organización de Google Workspace.

Para llamar a este método como administrador de Google Workspace, haz lo siguiente:

Para obtener más información y ejemplos, consulta Cómo administrar espacios de Google Chat como administrador de Google Workspace.

Limitaciones y consideraciones