REST Resource: groups

Risorsa: gruppo

Google Gruppi consente agli utenti di inviare messaggi a gruppi di persone utilizzando l'indirizzo email del gruppo. Per scoprire di più sulle attività comuni, consulta la Guida per gli sviluppatori.

Per informazioni sugli altri tipi di gruppi, consulta la documentazione dell'API Cloud Identity Groups.

Nota: l'utente che chiama l'API (o che ha l'identità di un account di servizio) deve avere un ruolo assegnato che includa le autorizzazioni dei Gruppi dell'API amministrativa, ad esempio Super amministratore o Amministratore gruppi.

Rappresentazione JSON
{
  "id": string,
  "email": string,
  "name": string,
  "description": string,
  "adminCreated": boolean,
  "directMembersCount": string,
  "kind": string,
  "etag": string,
  "aliases": [
    string
  ],
  "nonEditableAliases": [
    string
  ]
}
Campi
id

string

Sola lettura. L'ID univoco di un gruppo. Un gruppo id può essere utilizzato come URI della richiesta di gruppo groupKey.

email

string

L'indirizzo email del gruppo. Se il tuo account ha più domini, seleziona quello appropriato per l'indirizzo email. email deve essere univoco. Questa proprietà è obbligatoria durante la creazione di un gruppo. Gli indirizzi email dei gruppi sono soggetti alle stesse regole di utilizzo dei caratteri dei nomi utente. Per maggiori dettagli, visita il Centro assistenza.

name

string

Il nome visualizzato del gruppo.

description

string

Una descrizione estesa per aiutare gli utenti a determinare lo scopo di un gruppo. Ad esempio, puoi includere informazioni su chi dovrebbe iscriversi al gruppo, i tipi di messaggi da inviare al gruppo, i link alle domande frequenti sul gruppo o gruppi correlati. La lunghezza massima è di 4,096 caratteri.

adminCreated

boolean

Sola lettura. Il valore è true se questo gruppo è stato creato da un amministratore anziché da un utente.

directMembersCount

string (int64 format)

Il numero di utenti che sono membri diretti del gruppo. Se un gruppo è membro (secondario) di questo gruppo (principale), i membri del gruppo secondario non vengono conteggiati nella proprietà directMembersCount del gruppo principale.

kind

string

Il tipo di risorsa API. Per le risorse di Gruppi, il valore è admin#directory#group.

etag

string

ETag della risorsa.

aliases[]

string

Sola lettura. L'elenco di indirizzi email alias di un gruppo. Per aggiungere, aggiornare o rimuovere gli alias di un gruppo, utilizza i metodi groups.aliases. Se viene modificata nella richiesta POST o PUT di un gruppo, viene ignorata.

nonEditableAliases[]

string

Sola lettura. L'elenco di indirizzi email alias non modificabili del gruppo, esterni al dominio o ai sottodomini principali dell'account. Si tratta di indirizzi email funzionanti utilizzati dal gruppo. Si tratta di una proprietà di sola lettura restituita nella risposta dell'API per un gruppo. Se viene modificata nella richiesta POST o PUT di un gruppo, viene ignorata.

Metodi

delete

Elimina un gruppo.

get

Recupera le proprietà di un gruppo.

insert

Crea un gruppo.

list

Recupera tutti i gruppi di un dominio o di un utente a cui è stata assegnata una chiave utente (paginata).

patch

Aggiorna le proprietà di un gruppo.

update

Aggiorna le proprietà di un gruppo.