Method: spaces.create

Crée un espace. Permet de créer un espace nommé ou un chat de groupe dans Import mode. Pour obtenir un exemple, consultez Créer un espace.

Les types d'authentification suivants sont acceptés :

  • Authentification de l'application avec approbation de l'administrateur et l'un des champs d'application d'autorisation suivants :

    • https://www.googleapis.com/auth/chat.app.spaces.create
    • https://www.googleapis.com/auth/chat.app.spaces

  • Authentification des utilisateurs avec l'un des champs d'application d'autorisation suivants :

    • https://www.googleapis.com/auth/chat.spaces.create
    • https://www.googleapis.com/auth/chat.spaces
    • https://www.googleapis.com/auth/chat.import (espaces en mode importation uniquement)

Lors de l'authentification en tant qu'application, le champ space.customer doit être défini dans la requête.

Lorsque vous vous authentifiez en tant qu'application, l'application Chat est ajoutée en tant que membre de l'espace. Toutefois, contrairement à l'authentification humaine, l'application Chat n'est pas ajoutée en tant que gestionnaire de l'espace. Par défaut, tous les membres de l'espace peuvent supprimer l'application Chat de l'espace. Pour autoriser uniquement les gestionnaires d'espace à supprimer l'application d'un espace, définissez space.permission_settings.manage_apps sur managersAllowed.

L'appartenance à un espace lors de sa création dépend de l'endroit où il est créé :Import mode

  • Mode Importation : aucun membre n'est créé.
  • Tous les autres modes : l'utilisateur qui appelle est ajouté en tant que membre. Il s'agit des actions de conversion suivantes :
    • L'application elle-même lors de l'utilisation de l'authentification par application.
    • Utilisateur humain lors de l'utilisation de l'authentification de l'utilisateur.

Si le message d'erreur ALREADY_EXISTS s'affiche lorsque vous créez un espace, essayez un autre displayName. Il est possible qu'un espace existant dans l'organisation Google Workspace utilise déjà ce nom à afficher.

Requête HTTP

POST https://chat.googleapis.com/v1/spaces

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
requestId

string

Facultatif. Identifiant unique de cette demande. Nous vous recommandons d'utiliser un UUID aléatoire. Si vous spécifiez un ID de requête existant, l'espace créé avec cet ID est renvoyé au lieu d'un nouvel espace. Si vous spécifiez un ID de demande existant provenant de la même application Chat avec un utilisateur authentifié différent, une erreur est renvoyée.

Corps de la requête

Le corps de la requête contient une instance de Space.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Space.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/chat.app.spaces.create
  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.create

Pour en savoir plus, consultez le guide d'autorisation.