Method: spaces.create

Crée un espace. Peut être utilisé pour créer un espace nommé ou un chat de groupe en Import mode. Pour obtenir un exemple, consultez Créer un espace.

Prend en charge les types d'authentification suivants :

  • Authentification de l'application avec l'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 de l'utilisateur 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.

Lors de l'authentification 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 d'espace. Par défaut, l'application Chat peut être supprimée de l'espace par tous les membres 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 du fait qu'il soit créé en Import mode :

  • Mode importation : aucun membre n'est créé.
  • Tous les autres modes : l'utilisateur appelant est ajouté en tant que membre. Il s'agit de :
    • L'application elle-même lors de l'utilisation de l'authentification de l'application.
    • L'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. Un espace existant dans l'organisation Google Workspace peut déjà utiliser 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. ID unique pour cette requête. Nous vous recommandons d'utiliser un UUID aléatoire. La spécification d'un ID de requête rend la requête idempotente, ce qui garantit que plusieurs requêtes identiques avec le même ID de requête n'entraînent la création que d'un seul espace. Les requêtes suivantes avec le même ID de requête renvoient l'espace existant et ne le mettent pas à jour, même si les détails demandés diffèrent de l'état actuel.

Pour utiliser ce champ efficacement :

  • Assurez-vous que les requêtes suivantes sont identiques et utilisent les mêmes identifiants d'authentification que la requête d'origine.
  • Si un espace a déjà été créé avec l'ID de requête fourni, la requête renvoie cet espace. Notez que l'espace renvoyé peut ne pas être entièrement renseigné. L'API renvoie l'espace dans votre requête avec le nom de ressource attribué par le système. Pour récupérer les dernières métadonnées de l'espace, appelez spaces.get.
  • La réutilisation d'un ID de requête existant avec un utilisateur authentifié différent 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.

Niveaux d'accès 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.