Ce guide explique comment utiliser la méthode create
sur la ressource Space
de
l'API Google Chat pour créer un espace nommé.
La
Ressource Space
représente un endroit où les utilisateurs et les applications Chat peuvent envoyer des messages,
partager des fichiers et collaborer. Il existe plusieurs types d'espaces:
- Les messages privés (MP) sont des conversations entre deux utilisateurs ou un utilisateur et une application Chat.
- Les chats de groupe sont des conversations entre trois utilisateurs ou plus et Applications de chat
- Les espaces nommés sont des espaces permanents où les utilisateurs envoient des messages, partagent des fichiers et collaborer.
Un espace nommé est un endroit où les personnes envoient des messages, partagent des fichiers et
et collaborer. Les espaces nommés peuvent inclure des applications Chat. Espaces nommés
incluent des fonctionnalités supplémentaires permettant d'ajouter des conversations de groupe et des messages privés sans nom ;
n'ont pas, comme les gestionnaires d'espaces pouvant appliquer des paramètres d'administration,
des descriptions, et ajouter ou supprimer des utilisateurs et des applications. Après avoir créé un espace nommé,
le seul membre de l'espace
est l'utilisateur authentifié. L’espace n’a pas
inclure d'autres personnes ou applications ; pas même l'application Chat
qui les crée. Pour ajouter des personnes, créez des membres dans l'espace en appelant la méthode
Méthode create
le
Ressource Member
.
Pour savoir comment procéder, consultez Créer un abonnement.
Pour créer un espace nommé avec plusieurs membres, un chat de groupe sans nom entre trois personnes ou plus, une conversation par message privé entre deux personnes, ou un et l'application Chat qui appelle la API Chat : configurer un espace à la place.
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.
Créer un espace nommé
Pour créer un espace nommé, transmettez les éléments suivants dans votre requête:
- Spécifiez le champ d'application de l'autorisation
chat.spaces.create
ouchat.spaces
. - Appelez la méthode
Méthode
create
le RessourceSpace
. - Définissez
spaceType
surSPACE
. - Définir
displayName
au nom de l'espace visible par l'utilisateur. Dans l'exemple suivant,displayName
est définie surAPI-made
. - Si vous le souhaitez, définissez d'autres attributs d'espace, comme
spaceDetails
(description visible par l'utilisateur et ensemble de consignes pour l'espace).
Voici comment créer un espace nommé:
Python
- Dans votre répertoire de travail, créez un fichier nommé
chat_space_create_named.py
. Ajoutez le code suivant dans
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()
Dans votre répertoire de travail, créez et exécutez l'exemple:
python3 chat_space_create_named.py
Node.js
- Dans votre répertoire de travail, créez un fichier nommé
create-space.js
. Ajoutez le code suivant dans
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);
Dans votre répertoire de travail, exécutez l'exemple:
node create-space.js
Un espace nommé est créé. Pour accéder à l'espace, utilisez son ID de ressource
pour créer l'URL de l'espace. Vous pouvez trouver l'ID de ressource dans l'espace
name
dans le corps de la réponse Google Chat. Par exemple, si votre espace
name
est spaces/1234567
, vous pouvez accéder à l'espace à l'aide de la commande suivante :
URL: https://mail.google.com/chat/u/0/#chat/space/1234567
.
Articles associés
- Ajoutez des personnes et des applications à l'espace en créer des membres.
- Pour publier un message dans l'espace la création d'un message.
- En savoir plus sur un espace
- Répertorier les espaces
- Mettre à jour un espace
- Supprimer un espace
- Configurer un espace
- Recherchez un espace de messagerie privée.
- Rendre un espace visible par des utilisateurs spécifiques