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 ulteriori informazioni sulle attività comuni dei membri di un 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 dei 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 si aggiunge un membro a un gruppo. Il 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 apportate all'indirizzo email.

role

string

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

I valori accettati sono:

  • MANAGER: questo ruolo è disponibile solo se Google Groups for Business viene attivato utilizzando la Console di amministrazione. Vedi Attivare o disattivare Groups for Business. Un ruolo MANAGER può eseguire tutte le operazioni necessarie con un ruolo OWNER, ma non può assegnare a un membro il ruolo OWNER o eliminare il gruppo. Un gruppo può avere più membri MANAGER.
  • MEMBER: questo ruolo può iscriversi a un gruppo, visualizzare gli archivi delle discussioni e visualizzare l'elenco dei membri del gruppo. Per ulteriori informazioni sui ruoli dei membri, vedi 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 eliminare il gruppo. Un OWNER deve essere 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 accettati 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. (Attualmente non in uso)
  • GROUP: il membro è un altro gruppo.
  • USER: il membro è un utente.
status

string

Stato del membro (immutabile)

delivery_settings

string

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

I valori accettati sono:

  • ALL_MAIL: tutti i messaggi vengono recapitati 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. È possibile utilizzare un membro id come memberKey della richiesta di un membro.

Metodi

delete

Rimuove un membro da un gruppo.

get

Recupera le proprietà di un membro del gruppo.

hasMember

Verifica se l'utente specificato fa parte del gruppo.

insert

Aggiunge un utente al gruppo specificato.

list

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

patch

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

update

Aggiorna l'appartenenza di un utente al gruppo specificato.