REST Resource: members

Risorsa: membro

Un membro di Google Gruppi può essere un utente o un altro gruppo. Questo membro può essere interno o esterno ai domini del tuo account. Per saperne di più sulle attività comuni dei membri del gruppo, consulta la Guida per gli sviluppatori.

Rappresentazione JSON 
{
  "kind": string,
  "email": string,
  "role": string,
  "etag": string,
  "type": string,
  "status": string,
  "delivery_settings": string,
  "id": string
}
Campi
kind

string

Il tipo di risorsa API. Per le risorse Membri, il valore è admin#directory#member.
email

string

L'indirizzo email del membro. Un membro può essere un utente o un altro gruppo. Questa proprietà è obbligatoria quando aggiungi un membro a un gruppo. email deve essere univoco e non può essere un alias di un altro gruppo. Se l'indirizzo email viene modificato, l'API riflette automaticamente le modifiche.
role

string

Il ruolo del membro in un gruppo. L'API restituisce un errore per i cicli negli abbonamenti ai gruppi. Ad esempio, se group1 è un membro di group2, group2 non può essere un membro di group1. Per ulteriori informazioni sul ruolo di un membro, vedi Assegnare ruoli nel gruppo ai membri.

I valori accettabili sono:

  • MANAGER: questo ruolo è disponibile solo se Google Groups for Business è attivato utilizzando la Console di amministrazione. Consulta l'articolo Attivare o disattivare Groups for Business. Un ruolo MANAGER può eseguire tutte le operazioni di un ruolo OWNER, ad eccezione di promuovere un membro a OWNER o eliminare il gruppo. Un gruppo può avere più di MANAGER membri.
  • MEMBER: questo ruolo può iscriversi a un gruppo, visualizzare gli archivi delle discussioni e l'elenco dei membri del gruppo. Per ulteriori informazioni sui ruoli dei membri, consulta Assegnare ruoli nel gruppo ai membri.
  • OWNER: questo ruolo può inviare messaggi al gruppo, aggiungere o rimuovere membri, modificare i ruoli dei membri, modificare le impostazioni del gruppo ed eliminarlo. Un OWNER deve essere un membro del gruppo. Un gruppo può avere più di un OWNER.
etag

string

ETag della risorsa.
type

string

Il tipo di membro del gruppo.

I valori accettabili sono:

  • CUSTOMER: il membro rappresenta tutti gli utenti di un dominio. Non viene restituito un indirizzo email e l'ID restituito è l'ID cliente.
  • EXTERNAL: il membro è un utente o un gruppo esterno al dominio. (non attualmente utilizzato)
  • GROUP: il membro è un altro gruppo.
  • USER: il membro è un utente.
status

string

Stato del membro (non modificabile)
delivery_settings

string

Definisce le preferenze di recapito della posta del membro. Questo campo è supportato solo dai metodi insert, update e get.

I valori accettabili sono:

  • ALL_MAIL: tutti i messaggi, inviati non appena arrivano.
  • DAILY: non più di un messaggio al giorno.
  • DIGEST: fino a 25 messaggi raggruppati in un unico messaggio.
  • DISABLED: rimuovi l'abbonamento.
  • NONE: nessun messaggio.
id

string

L'ID univoco del membro del gruppo. Un membro id può essere utilizzato come memberKey dell'URI di richiesta di un membro.

Metodi

delete

 Rimuove un membro da un gruppo.

get

 Recupera le proprietà di un membro del gruppo.

hasMember

 Controlla se l'utente specificato è membro del gruppo.

insert

 Aggiunge un utente al gruppo specificato.

list

 Recupera un elenco paginato di tutti i membri di un gruppo.

patch

 Aggiorna le proprietà di appartenenza di un utente al gruppo specificato.

update

 Aggiorna l'appartenenza di un utente al gruppo specificato.