- Richiesta HTTP
- Parametri percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
Crea un abbonamento umano o all'app per l'app per le chiamate. La creazione di abbonamenti per altre app non è supportata. Ad esempio, vedi Invitare o aggiungere un utente o un'app Google Chat a uno spazio. Durante la creazione di un abbonamento, se il membro specificato ha disattivato le norme di accettazione automatica, riceverà un invito e dovrà accettare l'invito allo spazio prima di partecipare. Altrimenti, se crei un'iscrizione, il membro verrà aggiunto direttamente allo spazio specificato. Richiede l'autenticazione dell'utente.
Per specificare il membro da aggiungere, imposta membership.member.name
per l'utente o il membro dell'app oppure imposta membership.group_member.name
per il membro del gruppo.
Per aggiungere l'app per le chiamate a uno spazio o a un messaggio diretto tra due utenti, usa
users/app
. Impossibile aggiungere altre app allo spazio.Per aggiungere un utente, utilizza
users/{user}
, dove{user}
può essere l'indirizzo email dell'utente. Per gli utenti della stessa organizzazione Workspace,{user}
può anche essere ilid
per la persona dell'API People o ilid
per l'utente nell'API Directory. Ad esempio, se l'ID profilo persona dell'API People diuser@example.com
è123456789
, puoi aggiungere l'utente allo spazio impostandomembership.member.name
suusers/user@example.com
ousers/123456789
.Per aggiungere o invitare un gruppo Google in uno spazio denominato, utilizza
groups/{group}
, dove{group}
è ilid
del gruppo dell'API Cloud Identity Groups. Ad esempio, puoi utilizzare l'API Cloud Identity Groups lookup per recuperare l'ID123456789
per l'email di gruppogroup@example.com
, quindi puoi aggiungere o invitare il gruppo in uno spazio denominato impostandomembership.group_member.name
sugroups/123456789
. L'email di gruppo non è supportata e i gruppi Google possono essere aggiunti solo come membri negli spazi denominati.
Richiesta HTTP
POST https://chat.googleapis.com/v1/{parent=spaces/*}/members
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
parent |
Obbligatoria. Il nome della risorsa dello spazio per il quale creare l'appartenenza. Formato: workspace/{space} |
Parametri di ricerca
Parametri | |
---|---|
useAdminAccess |
true , il metodo viene eseguito utilizzando i privilegi amministrativi di Google Workspace dell'utente.L'utente che chiama deve essere un amministratore di Google Workspace con il privilegio di gestione delle conversazioni di Chat e spazi. Richiede l'ambito OAuth 2.0 La creazione di abbonamenti per app o la creazione di abbonamenti per gli utenti esterni all'organizzazione Google Workspace dell'amministratore non è supportata utilizzando l'accesso amministrativo. |
Corpo della richiesta
Il corpo della richiesta contiene un'istanza di Membership
.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di Membership
appena creata.
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/chat.admin.memberships
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.app
Per ulteriori informazioni, consulta la Guida all'autorizzazione.