Method: spaces.members.create

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 il id per la persona dell'API People o il id per l'utente nell'API Directory. Ad esempio, se l'ID profilo persona dell'API People di user@example.com è 123456789, puoi aggiungere l'utente allo spazio impostando membership.member.name su users/user@example.com o users/123456789.

  • Per aggiungere o invitare un gruppo Google in uno spazio denominato, 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, quindi puoi aggiungere o invitare il gruppo in uno spazio denominato impostando membership.group_member.name su groups/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

string

Obbligatoria. Il nome della risorsa dello spazio per il quale creare l'appartenenza.

Formato: workspace/{space}

Parametri di ricerca

Parametri
useAdminAccess

boolean

Quando 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 chat.admin.memberships.

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.