- Richiesta HTTP
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
Crea uno spazio. Può essere utilizzato per creare uno spazio denominato o una chat di gruppo in Import mode. Per un esempio, vedi Creare uno spazio.
Supporta i seguenti tipi di autenticazione:
Quando esegui l'autenticazione come app, il campo space.customer deve essere impostato nella richiesta.
L'appartenenza allo spazio al momento della creazione dipende dal fatto che lo spazio sia stato creato in Import mode:
- Modalità di importazione: non vengono creati membri.
- Tutte le altre modalità: l'utente che effettua la chiamata viene aggiunto come membro. ovvero:
- L'app stessa quando utilizzi l'autenticazione delle app.
- L'utente quando si utilizza l'autenticazione utente.
Se ricevi il messaggio di errore ALREADY_EXISTS durante la creazione di uno spazio, prova con un altro displayName. Uno spazio esistente all'interno dell'organizzazione Google Workspace potrebbe già utilizzare questo nome visualizzato.
Richiesta HTTP
POST https://chat.googleapis.com/v1/spaces
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri di query
| Parametri | |
|---|---|
request |
Facoltativo. Un identificatore univoco per questa richiesta. È consigliabile utilizzare un UUID casuale. Se specifichi un ID richiesta esistente, viene restituito lo spazio creato con quell'ID anziché crearne uno nuovo. Se specifichi un ID richiesta esistente della stessa app Chat con un utente autenticato diverso, viene restituito un errore. |
Corpo della richiesta
Il corpo della richiesta contiene un'istanza di Space.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di Space appena creata.
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/chat.app.spaces.createhttps://www.googleapis.com/auth/chat.app.spaceshttps://www.googleapis.com/auth/chat.importhttps://www.googleapis.com/auth/chat.spaceshttps://www.googleapis.com/auth/chat.spaces.create
Per ulteriori informazioni, consulta la Guida all'autorizzazione.