REST Resource: members

Risorsa: membro

Un membro di Google Gruppi può essere un utente o un altro gruppo. Questo membro può appartenere o meno 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 si aggiunge 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 apportate.

role

string

Il ruolo del membro in un gruppo. L'API restituisce un errore per i cicli nelle iscrizioni 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 i ruoli di gruppo ai membri.

I valori accettati sono:

  • MANAGER: questo ruolo è disponibile solo se Google Groups for Business è stato abilitato utilizzando la Console di amministrazione. Vedi Attivare o disattivare Groups for Business. Un ruolo MANAGER può eseguire tutte le azioni di un ruolo OWNER, tranne rendere un membro OWNER o eliminare il gruppo. Un gruppo può avere più membri di MANAGER.
  • MEMBER: questo ruolo può iscriversi a un gruppo, visualizzare gli archivi delle discussioni e visualizzare l'elenco dei membri del gruppo. Per saperne di più sui ruoli dei membri, vedi Assegnare i ruoli dei gruppi 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 di 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, 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. Un membro id può essere utilizzato come URI della richiesta di un membro memberKey.

Metodi

delete

Rimuove un membro da un gruppo.

get

Recupera le proprietà di un membro del gruppo.

hasMember

Controlla 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.