Ce guide explique comment utiliser la méthode create
sur la ressource membership
.
de l'API Google Chat pour inviter ou ajouter un utilisateur, un groupe Google
Application de chat à un espace, également appelé "création d'un
. Lors de la création d'un abonnement, si le membre spécifié possède ses
règle d'acceptation automatique désactivée, l'utilisateur est invité et doit accepter l'espace
invitation avant de vous inscrire. Sinon, la création d'un abonnement ajoute le membre
directement à l'espace spécifié.
La
Ressource Membership
indique si un utilisateur humain ou une application Google Chat est invité,
est inclus ou absent d'un espace.
Prérequis
Python
- Une entreprise Un compte Google Workspace ayant accès à Google Chat :
- Configurez votre environnement:
<ph type="x-smartling-placeholder">
- </ph>
- Créez un projet Google Cloud.
- Configurer l'écran de consentement OAuth
- activer et configurer l'API Google Chat à l'aide d'un nom ; et la description de votre application Chat.
- Installez la Python Bibliothèque cliente des API Google.
- <ph type="x-smartling-placeholder"></ph>
Créez des identifiants client OAuth pour une application de bureau. Pour exécuter l'exemple
enregistrez les identifiants dans un fichier JSON nommé
client_secrets.json
dans votre dans votre répertoire local.
- <ph type="x-smartling-placeholder"></ph> Choisissez un niveau d'autorisation compatible avec l'authentification des utilisateurs.
Node.js
- Une entreprise Un compte Google Workspace ayant accès à Google Chat :
- Configurez votre environnement:
<ph type="x-smartling-placeholder">
- </ph>
- Créez un projet Google Cloud.
- Configurer l'écran de consentement OAuth
- activer et configurer l'API Google Chat à l'aide d'un nom ; et la description de votre application Chat.
- Installez la Node.js Bibliothèque cliente des API Google.
- <ph type="x-smartling-placeholder"></ph>
Créez des identifiants client OAuth pour une application de bureau. Pour exécuter l'exemple
enregistrez les identifiants dans un fichier JSON nommé
client_secrets.json
dans votre dans votre répertoire local.
- <ph type="x-smartling-placeholder"></ph> Choisissez un niveau d'autorisation compatible avec l'authentification des utilisateurs.
Inviter ou ajouter un utilisateur à un espace
Pour inviter ou ajouter un utilisateur à un espace, transmettez les éléments suivants dans votre requête:
- Spécifiez le champ d'application de l'autorisation
chat.memberships
. - Appelez la méthode
Méthode
create
le Ressourcemembership
. - Définissez
parent
sur le nom de ressource de l'espace dans lequel vous souhaitez créer des membres. - Définissez
member
surusers/{user}
, où{user}
correspond à la personne que vous souhaitez contacter. créer un abonnement et est soit: <ph type="x-smartling-placeholder">- </ph>
- L'ID de
personne
dans l'API People. Par exemple, si l'API People
personne
resourceName
est défini surpeople/123456789
, puis défini surmembership.member.name
àusers/123456789
. - L'ID de utilisateur dans l'API Directory.
- Adresse e-mail de l'utilisateur. Par exemple,
users/222larabrown@gmail.com
ouusers/larabrown@cymbalgroup.com
. Si l'utilisateur utilise un compte Google ou appartient à une autre organisation Google Workspace, vous devez utiliser son adresse e-mail.
- L'ID de
personne
dans l'API People. Par exemple, si l'API People
personne
L'exemple suivant ajoute un utilisateur à un espace:
Python
- Dans votre répertoire de travail, créez un fichier nommé
chat_membership_user_create.py
Ajoutez le code suivant dans
chat_membership_user_create.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"] def main(): ''' Authenticates with Chat API via user credentials, then adds a user to a Chat space by creating a 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().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()
Dans le code, remplacez les éléments suivants:
SPACE
: un nom d'espace, qui que vous pouvez obtenir Méthodespaces.list
dans l'API Chat ou via l'URL d'un espace.USER
: un ID utilisateur
Dans votre répertoire de travail, créez et exécutez l'exemple:
python3 chat_membership_user_create.py
Node.js
- Dans votre répertoire de travail, créez un fichier nommé
add-user-to-space.js
. Ajoutez le code suivant dans
add-user-to-space.js
:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Adds the user to the Chat space. * @return {!Promise<!Object>} */ async function addUserToSpace() { const scopes = [ 'https://www.googleapis.com/auth/chat.memberships', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); const chatClient = await chat.chat({version: 'v1', auth: authClient}); return await chatClient.spaces.members.create({ parent: 'spaces/SPACE', requestBody: {member: {name: 'users/USER', type: 'HUMAN'}} }); } addUserToSpace().then(console.log);
Dans le code, remplacez les éléments suivants:
SPACE
: nom d'espace, que vous pouvez obtenir à partir du Méthodespaces.list
dans l'API Chat ou via l'URL d'un espace.USER
: un ID utilisateur
Dans votre répertoire de travail, exécutez l'exemple:
node add-user-to-space.js
L'API Chat renvoie une instance de
membership
qui détaille l'appartenance
utilisateur qui a été créée.
Inviter ou ajouter un groupe Google à un espace
Pour inviter ou ajouter un groupe Google à un espace, transmettez les éléments suivants dans votre requête:
- Spécifiez le champ d'application de l'autorisation
chat.memberships
. - Appelez la méthode
Méthode
create
le Ressourcemembership
. - Définissez
parent
sur le nom de ressource de l'espace dans lequel vous souhaitez créer des membres. - Définissez
groupMember
surgroups/{group}
, où{group}
est l'ID du groupe que vous pour lequel vous voulez créer un abonnement. Vous pouvez récupérer l'identifiant du groupe à l'aide de la méthode API Cloud Identity : Par exemple, si l'API Cloud Identity renvoie un groupe nommégroups/123456789
, puis définit Demembership.groupMember.name
àgroups/123456789
.
Vous ne pouvez pas ajouter de groupes Google Groupes à un chat de groupe ou à un message privé, mais uniquement à un un espace nommé. L'exemple suivant ajoute un groupe à un espace nommé:
Python
- Dans votre répertoire de travail, créez un fichier nommé
chat_membership_group_create.py
Ajoutez le code suivant dans
chat_membership_group_create.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"] def main(): ''' Authenticates with Chat API via user credentials, then adds a group to a Chat space by creating a 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().create( # The named space in which to create a membership. parent = 'spaces/SPACE', # Specify which group the membership is for. body = { 'groupMember': { 'name':'groups/GROUP', } } ).execute() # Prints details about the created membership. print(result) if __name__ == '__main__': main()
Dans le code, remplacez les éléments suivants:
SPACE
: un nom d'espace, qui que vous pouvez obtenir Méthodespaces.list
dans l'API Chat ou via l'URL d'un espace.GROUP
: ID de groupe.
Dans votre répertoire de travail, créez et exécutez l'exemple:
python3 chat_membership_group_create.py
Node.js
- Dans votre répertoire de travail, créez un fichier nommé
add-group-to-space.js
. Ajoutez le code suivant dans
add-group-to-space.js
:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Adds the group to the Chat space. * @return {!Promise<!Object>} */ async function addUserToSpace() { const scopes = [ 'https://www.googleapis.com/auth/chat.memberships', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); const chatClient = await chat.chat({version: 'v1', auth: authClient}); return await chatClient.spaces.members.create({ parent: 'spaces/SPACE', requestBody: {groupMember: {name: 'groups/GROUP'}} }); } addUserToSpace().then(console.log);
Dans le code, remplacez les éléments suivants:
SPACE
: nom d'espace, que vous pouvez obtenir à partir du Méthodespaces.list
dans l'API Chat ou via l'URL d'un espace.GROUP
: ID de groupe.
Dans votre répertoire de travail, exécutez l'exemple:
node add-group-to-space.js
L'API Chat renvoie une instance de
membership
qui détaille l'appartenance
au groupe qui a été créée.
Ajouter une application Chat à un espace
Une application Chat ne peut pas ajouter une autre application en tant que membre d'une l'espace de stockage. Ajouter une application Chat à un espace ou un message privé entre deux utilisateurs, transmettez les éléments suivants dans votre requête:
- Spécifiez le champ d'application de l'autorisation
chat.memberships.app
. - Appelez la méthode
Méthode
create
sur la ressourcemembership
. - Définissez
parent
sur le nom de ressource de l'espace dans lequel vous souhaitez créer des membres. - Définissez
member
surusers/app
. Un alias qui représente l'application qui appelle API Chat.
L'exemple suivant ajoute une application Chat à un espace:
Python
- Dans votre répertoire de travail, créez un fichier nommé
chat_membership_app_create.py
Ajoutez le code suivant dans
chat_membership_app_create.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.app"] def main(): ''' Authenticates with Chat API via user credentials, then adds the Chat app to 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().members().create( # The space in which to create a membership. parent = 'spaces/SPACE', # Set the Chat app as the entity that gets added to the space. # 'app' is an alias for the Chat app calling the API. body = { 'member': { 'name':'users/app', 'type': 'BOT' } } ).execute() # Prints details about the created membership. print(result) if __name__ == '__main__': main()
Dans le code, remplacez
SPACE
par un nom d'espace, ce qui que vous pouvez obtenir Méthodespaces.list
dans l'API Chat ou via l'URL d'un espace.Dans votre répertoire de travail, créez et exécutez l'exemple:
python3 chat_membership_app_create.py
Node.js
- Dans votre répertoire de travail, créez un fichier nommé
add-app-to-space.js
. Ajoutez le code suivant dans
add-app-to-space.js
:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Adds the app to the Chat space. * @return {!Promise<!Object>} */ async function addAppToSpace() { const scopes = [ 'https://www.googleapis.com/auth/chat.memberships.app', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); const chatClient = await chat.chat({version: 'v1', auth: authClient}); return await chatClient.spaces.members.create({ parent: 'spaces/SPACE', requestBody: {member: {name: 'users/app', type: 'BOT'}} }); } addAppToSpace().then(console.log);
Dans le code, remplacez
SPACE
par un nom d'espace, ce qui que vous pouvez obtenir Méthodespaces.list
dans l'API Chat ou via l'URL d'un espace.Dans votre répertoire de travail, exécutez l'exemple:
node add-app-to-space.js
L'API Chat renvoie une instance de
membership
qui détaille l'appartenance à l'application qui a été créée.
Articles associés
- Obtenez des informations sur l'abonnement d'un utilisateur ou dans l'application Chat.
- Lister les membres d'un espace
- Modifier l'appartenance d'un utilisateur à un espace Google Chat
- Exclure un utilisateur ou une application Chat d'un espace