Crea uno spazio e aggiunge gli utenti specificati. L'utente che effettua la chiamata viene aggiunto automaticamente allo spazio e non deve essere specificato come appartenenza nella richiesta. Per un esempio, vedi Configurare uno spazio con i membri iniziali.
Per specificare i membri da aggiungere, aggiungi abbonamenti con il membership.member.name
appropriato. Per aggiungere un utente umano, utilizza users/{user}
, dove {user}
può essere l'indirizzo email dell'utente. Per gli utenti della stessa organizzazione Workspace, {user}
può anche essere il id
per la persona dell'API People o il id
per l'utente nell'API Directory. Ad esempio, se l'ID profilo della persona dell'API People per user@example.com
è 123456789
, puoi aggiungere l'utente allo spazio impostando membership.member.name
su users/user@example.com
o users/123456789
.
Per specificare i gruppi Google da aggiungere, aggiungi le iscrizioni con il membership.group_member.name
appropriato. Per aggiungere o invitare un gruppo Google, utilizza groups/{group}
, dove {group}
è il id
del gruppo dell'API Cloud Identity Groups. Ad esempio, puoi utilizzare l'API Cloud Identity Groups lookup per recuperare l'ID 123456789
per l'email di gruppo group@example.com
e poi aggiungere il gruppo allo spazio impostando membership.group_member.name
su groups/123456789
. L'email di gruppo non è supportata e i gruppi Google possono essere aggiunti come membri solo negli spazi con nome.
Per uno spazio denominato o una chat di gruppo, se il chiamante blocca, è bloccato da alcuni membri o non dispone dell'autorizzazione per aggiungere alcuni membri, questi membri non verranno aggiunti allo spazio creato.
Per creare un messaggio diretto (DM) tra l'utente che chiama e un altro utente, specifica esattamente un'appartenenza per rappresentare l'utente. Se un utente blocca l'altro, la richiesta non va a buon fine e il messaggio diretto non viene creato.
Per creare un messaggio diretto tra l'utente che effettua la chiamata e l'app di chiamata, imposta Space.singleUserBotDm
su true
e non specificare alcun gruppo di appartenenza. Puoi utilizzare questo metodo solo per configurare un messaggio diretto con l'app per le chiamate. Per aggiungere l'app per le chiamate come membro di uno spazio o come messaggio diretto esistente tra due utenti umani, vedi Invitare o aggiungere un utente o un'app a uno spazio.
Se esiste già un messaggio diretto tra due utenti, anche quando un utente blocca l'altro quando viene effettuata una richiesta, viene restituito il messaggio diretto esistente.
Gli spazi con risposte in thread non sono supportati. Se ricevi il messaggio di errore ALREADY_EXISTS
durante la configurazione di uno spazio, prova un altro displayName
. Uno spazio esistente all'interno dell'organizzazione Google Workspace potrebbe già utilizzare questo nome visualizzato.
Richiede l'autenticazione utente.
Richiesta HTTP
POST https://chat.googleapis.com/v1/spaces:setup
L'URL utilizza la sintassi di transcodifica gRPC.
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "space": { object ( |
Campi | |
---|---|
space |
Obbligatorio. Il campo Per creare uno spazio, imposta Per creare una chat di gruppo, imposta Per creare una conversazione 1:1 tra persone, imposta Per creare una conversazione 1:1 tra una persona e l'app Chat per le chiamate, imposta Se esiste già uno spazio |
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. |
memberships[] |
(Facoltativo) Gli utenti o i gruppi di Google Chat da invitare a partecipare allo spazio. Ometti l'utente chiamante poiché viene aggiunto automaticamente. L'impostazione attualmente consente fino a 20 abbonamenti (oltre al chiamante). Per l'appartenenza umana, il campo Per l'appartenenza al gruppo Google, il campo Facoltativo se imposti Obbligatorio quando Richiesto quando si imposta Deve essere vuoto durante la creazione di una conversazione 1:1 tra una persona e l'app Chat per le chiamate (se |
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di Space
.
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/chat.spaces
https://www.googleapis.com/auth/chat.spaces.create
Per ulteriori informazioni, consulta la Guida all'autorizzazione.