REST Resource: spaces.members

Risorsa: Abbonamento

Rappresenta una relazione di appartenenza in Google Chat, ad esempio se un utente o un'app Chat è invitato a uno spazio, ne fa parte o non è presente.

Rappresentazione JSON 
{
  "name": string,
  "state": enum (MembershipState),
  "role": enum (MembershipRole),
  "createTime": string,
  "deleteTime": string,

  // Union field memberType can be only one of the following:
  "member": {
    object (User)
  },
  "groupMember": {
    object (Group)
  }
  // End of list of possible types for union field memberType.
}
Campi
name

string

Identificatore. Nome risorsa dell'abbonamento, assegnato dal server.

Formato: spaces/{space}/members/{member}
state

enum (MembershipState)

Solo output. Stato dell'abbonamento.
role

enum (MembershipRole)

Facoltativo. Il ruolo dell'utente all'interno di uno spazio di Chat, che determina le azioni consentite nello spazio.

Questo campo può essere utilizzato solo come input in members.patch.
createTime

string (Timestamp format)

Facoltativo. Immutabile. L'ora di creazione dell'abbonamento, ad esempio quando un membro ha partecipato o è stato invitato a partecipare a uno spazio. Questo campo è solo di output, tranne quando viene utilizzato per importare abbonamenti storici negli spazi in modalità di importazione.
deleteTime

string (Timestamp format)

Facoltativo. Immutabile. L'ora di eliminazione dell'iscrizione, ad esempio quando un membro ha lasciato o è stato rimosso da uno spazio. Questo campo è solo di output, tranne quando viene utilizzato per importare abbonamenti storici negli spazi in modalità di importazione.
Campo unione memberType. Membro associato a questo abbonamento. In futuro potrebbero essere supportati altri tipi di membri. memberType può essere solo uno dei seguenti:
member

object (User)

Facoltativo. L'utente o l'app Google Chat a cui corrisponde l'iscrizione. Se la tua app di chat esegue l'autenticazione come utente, l'output compila i campi user name e type.
groupMember

object (Group)

Facoltativo. Il gruppo Google a cui corrisponde l'appartenenza.

La lettura o la modifica delle iscrizioni per Google Gruppi richiede l'autenticazione utente.

MembershipState

Specifica la relazione del membro con uno spazio. In futuro potrebbero essere supportati altri stati di abbonamento.

Enum
MEMBERSHIP_STATE_UNSPECIFIED Valore predefinito. Non utilizzare.
JOINED L'utente viene aggiunto allo spazio e può parteciparvi.
INVITED L'utente è invitato a partecipare allo spazio, ma non l'ha ancora fatto.
NOT_A_MEMBER L'utente non appartiene allo spazio e non ha un invito in attesa per entrare nello spazio.

MembershipRole

Rappresenta le azioni consentite a un utente in uno spazio di Chat. In futuro potrebbero essere aggiunti altri valori enum.

Enum
MEMBERSHIP_ROLE_UNSPECIFIED Valore predefinito. Per users: non è membro dello spazio, ma può essere invitato. Per Google Groups: questo ruolo viene sempre assegnato (in futuro potrebbero essere utilizzati altri valori enum).
ROLE_MEMBER

Un membro dello spazio. Nell'interfaccia utente di Chat, questo ruolo è chiamato Membro.

L'utente dispone di autorizzazioni di base, come l'invio di messaggi allo spazio. I gestori e i proprietari possono concedere ai membri autorizzazioni aggiuntive in uno spazio, tra cui:

  • Aggiungere o rimuovere membri.
  • Modifica i dettagli dello spazio.
  • Attivare o disattivare la cronologia.
  • Menzionare tutti nello spazio con @all.
  • Gestisci le app Chat e i webhook installati nello spazio.

Nei messaggi diretti e nelle conversazioni di gruppo senza nome, tutti hanno questo ruolo.
ROLE_MANAGER

Un proprietario dello spazio. Nell'interfaccia utente della chat, questo ruolo è chiamato Proprietario.

L'utente dispone dell'insieme completo di autorizzazioni dello spazio per gestire lo spazio, tra cui:

  • Cambiare il ruolo degli altri membri dello spazio in membro, gestore o proprietario.
  • Elimina lo spazio.

Supportato solo in SpaceType.SPACE (spazi con nome).

Per saperne di più, vedi Scopri di più sul tuo ruolo di proprietario o gestore dello spazio.
ROLE_ASSISTANT_MANAGER

Un gestore dello spazio. Nell'UI della chat, questo ruolo è chiamato Manager.

L'utente dispone di tutte le autorizzazioni di base di ROLE_MEMBER e un proprietario può concedergli un sottoinsieme di autorizzazioni amministrative. Per impostazione predefinita, i gestori hanno tutte le autorizzazioni di un proprietario, ad eccezione della possibilità di:

  • Elimina lo spazio.
  • Rendere proprietario un altro membro dello spazio.
  • Modificare il ruolo di un proprietario.

Per impostazione predefinita, le autorizzazioni dei gestori includono, a titolo esemplificativo:

  • Impostare un altro membro come gestore.
  • Eliminare i messaggi nello spazio.
  • Gestisci le autorizzazioni dello spazio.
  • Ricevere notifiche per le richieste di partecipazione allo spazio se il gestore dispone dell'autorizzazione "Gestisci membri" nelle impostazioni dello spazio.
  • Rendere rilevabile uno spazio.

Supportato solo in SpaceType.SPACE (spazi con nome).

Per saperne di più, vedi Gestire le impostazioni dello spazio.

Gruppo

Un gruppo Google in Google Chat.

Rappresentazione JSON 
{
  "name": string
}
Campi
name

string

Nome della risorsa per un gruppo Google.

Rappresenta un gruppo nell'API Cloud Identity Groups.

Formato: groups/{group}

Metodi

create

 Crea un abbonamento per l'app Chat per le chiamate, un utente o un gruppo Google.

delete

 Elimina un abbonamento.

get

 Restituisce i dettagli di un abbonamento.

list

 Elenca le iscrizioni in uno spazio.

patch

 Aggiorna un abbonamento.