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 la section Créer un espace.

Compatible avec les types d'authentification suivants:

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

L'appartenance à un espace lors de sa création dépend de son appartenance à Import mode:

  • Mode importation:aucun membre n'est créé.
  • Tous les autres modes:l'utilisateur appelant est ajouté en tant que membre. Voici pourquoi :
    • L'application elle-même lorsque vous utilisez l'authentification de l'application.
    • Utilisateur humain lors 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 de 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 requête. 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'en créer un autre. Spécifier un ID de requête existant de la même application Chat avec un autre utilisateur authentifié génère une erreur.

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.