En esta guía, se explica cómo usar el método create
en el recurso Space
de
la API de Google Chat para crear un espacio con nombre.
El
Recurso Space
representa un lugar donde 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 Apps de Chat
- Los espacios con nombre son lugares persistentes donde las personas envían mensajes, y colaborar.
Un espacio con nombre es un lugar donde las personas envían mensajes, comparten archivos y
colaborar. Los espacios con nombre pueden incluir apps de Chat. Espacios con nombre
Incluyen funciones adicionales que permiten que las conversaciones grupales y los mensajes directos sin nombre
no tienes, como los administradores del espacio que pueden aplicar la configuración administrativa,
descripciones, y agregar o quitar personas y apps. Después de crear un espacio con nombre,
el único miembro del espacio es el usuario autenticado. El espacio
incluir a otras personas o aplicaciones ni siquiera la app de Chat
que la crea. Para agregar personas, crea membresías en el espacio llamando al
Método create
en la
Recurso Member
.
Si quieres obtener más información, consulta Cómo crear una membresía.
Para crear un espacio con nombre de varios miembros, un chat en grupo sin nombre entre tres o más personas, o una conversación de mensaje directo entre dos personas, o y la app de Chat que llama API de Chat: Configura un espacio en su lugar.
Requisitos previos
Python
- Una empresa o empresa de Google Workspace con acceso a Google Chat.
- 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
- Configura tu entorno:
- Crea un proyecto de Google Cloud
- Configura la pantalla de consentimiento de OAuth.
- Habilita y configura la API de Google Chat con un nombre. y la descripción de tu app de Chat.
-
Crea credenciales de ID de cliente de OAuth para una aplicación de escritorio. Para ejecutar la muestra
guarda las credenciales como un archivo JSON (
client_secrets.json
) en tu directorio local.
- Elige un alcance de autorización que admita la autenticación de usuarios.
Node.js
- Una empresa o empresa de Google Workspace con acceso a Google Chat.
- Node.js 14 o versiones posteriores
- La herramienta npm herramienta de administración de paquetes
- Las bibliotecas cliente de Google más recientes. Para instalarlas o actualizarlas,
Ejecuta el siguiente comando en tu interfaz de línea de comandos:
npm install @google-cloud/local-auth @googleapis/chat
- Configura tu entorno:
- Crea un proyecto de Google Cloud
- Configura la pantalla de consentimiento de OAuth.
- Habilita y configura la API de Google Chat con un nombre. y la descripción de tu app de Chat.
-
Crea credenciales de ID de cliente de OAuth para una aplicación de escritorio. Para ejecutar la muestra
guarda las credenciales como un archivo JSON (
client_secrets.json
) en tu directorio local.
- Elige un alcance de autorización que admita la autenticación de usuarios.
Crea un espacio con nombre
Para crear un espacio con nombre, pasa lo siguiente en la solicitud:
- Especifica el permiso de autorización
chat.spaces.create
ochat.spaces
. - Llama al
Método
create
en la RecursoSpace
. - Configura
spaceType
comoSPACE
. - Definir
displayName
al nombre del espacio que ve el usuario. En el siguiente ejemplo,displayName
se estableció enAPI-made
. - De manera opcional, establece otros atributos de espacio, como
spaceDetails
(una descripción visible para el usuario y un conjunto de lineamientos del espacio).
A continuación, te mostramos cómo crear un espacio con nombre:
Python
- En el directorio de trabajo, crea un archivo llamado
chat_space_create_named.py
. Incluye el siguiente código en
chat_space_create_named.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.spaces.create"] def main(): ''' Authenticates with Chat API via user credentials, then creates a Chat space. ''' # 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().create( # Details about the space to create. body = { # To create a named space, set spaceType to SPACE. 'spaceType': 'SPACE', # The user-visible name of the space. 'displayName': 'API-made' } ).execute() # Prints details about the created space. print(result) if __name__ == '__main__': main()
En tu directorio de trabajo, compila y ejecuta la muestra:
python3 chat_space_create_named.py
Node.js
- En el directorio de trabajo, crea un archivo llamado
create-space.js
. Incluye el siguiente código en
create-space.js
:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Creates a new chat space. * @return {!Promise<!Object>} */ async function createSpace() { const scopes = [ 'https://www.googleapis.com/auth/chat.spaces.create', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); const chatClient = await chat.chat({version: 'v1', auth: authClient}); return await chatClient.spaces.create( {requestBody: {spaceType: 'SPACE', displayName: 'API-made'}}); } createSpace().then(console.log);
En tu directorio de trabajo, ejecuta la muestra:
node create-space.js
Se crea un espacio con nombre. Para navegar al espacio, usa su ID de recurso.
para compilar la URL del espacio. Puedes encontrar el ID del recurso en el espacio
name
en el cuerpo de la respuesta de Google Chat Por ejemplo, si tu espacio
name
es spaces/1234567
, puedes navegar al espacio con las siguientes opciones
URL: https://mail.google.com/chat/u/0/#chat/space/1234567
.
Temas relacionados
- Agrega personas y apps al espacio crear miembros.
- Publica un mensaje en el espacio por crear un mensaje.
- Obtener detalles sobre un espacio
- Crea listas de espacios.
- Actualiza un espacio.
- Borra un espacio.
- Configura un espacio.
- Busca un espacio para mensaje directo.
- Haz que usuarios específicos puedan encontrar un espacio.