Method: spaces.create

Crea uno spazio. Può essere utilizzato per creare uno spazio denominato o una chat di gruppo in Import mode. Per un esempio, consulta Creare uno spazio.

Supporta i seguenti tipi di autenticazione:

  • Autenticazione dell'app con approvazione dell'amministratore e uno dei seguenti ambiti di autorizzazione:

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

  • Autenticazione utente con uno dei seguenti ambiti di autorizzazione:

    • https://www.googleapis.com/auth/chat.spaces.create
    • https://www.googleapis.com/auth/chat.spaces
    • https://www.googleapis.com/auth/chat.import (solo spazi in modalità di importazione)

Quando esegui l'autenticazione come app, il campo space.customer deve essere impostato nella richiesta.

Quando esegui l'autenticazione come app, l'app Chat viene aggiunta come membro dello spazio. Tuttavia, a differenza dell'autenticazione umana, l'app Chat non viene aggiunta come gestore dello spazio. Per impostazione predefinita, l'app Chat può essere rimossa dallo spazio da tutti i membri dello spazio. Per consentire solo ai gestori dello spazio di rimuovere l'app da uno spazio, imposta space.permission_settings.manage_apps su managersAllowed.

L'appartenenza allo spazio al momento della creazione dipende dal fatto che lo spazio venga creato in Import mode:

  • Import mode: non vengono creati membri.
  • Tutte le altre modalità: l'utente che chiama viene aggiunto come membro. Questo è:
    • L'app stessa quando si utilizza l'autenticazione dell'app.
    • L'utente umano quando si utilizza l'autenticazione utente.

Se ricevi il messaggio di errore ALREADY_EXISTS durante la creazione di uno spazio, prova a utilizzare un displayName diverso. 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 ricerca

Parametri
requestId

string

Facoltativo. Un ID univoco per questa richiesta. È consigliabile utilizzare un UUID casuale. Se specifichi un ID richiesta, la richiesta diventa idempotente, il che garantisce che più richieste identiche con lo stesso ID richiesta comportino la creazione di un solo spazio. Le richieste successive con lo stesso ID richiesta restituiscono lo spazio esistente e non lo aggiornano, anche se i dettagli richiesti differiscono dallo stato attuale.

Per utilizzare questo campo in modo efficace:

  • Assicurati che le richieste successive siano identiche e utilizzino le stesse credenziali di autenticazione della richiesta originale.
  • Se è già stato creato uno spazio con l'ID richiesta fornito, la richiesta restituisce lo spazio. Tieni presente che lo spazio restituito potrebbe non essere completamente compilato. L'API riproduce lo spazio nella richiesta con il nome della risorsa assegnato dal sistema. Per recuperare i metadati più recenti dello spazio, chiama spaces.get.
  • Il riutilizzo di un ID richiesta esistente con un utente autenticato diverso genera 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.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

Per ulteriori informazioni, consulta la guida all'autorizzazione.