REST Resource: groups

Risorsa: gruppo

Google Gruppi offre ai tuoi utenti la possibilità di inviare messaggi a gruppi di persone utilizzando l'indirizzo email del gruppo. Per ulteriori informazioni sulle attività comuni, consulta la Guida per gli sviluppatori.

Per informazioni su altri tipi di gruppi, consulta la documentazione relativa all'API Cloud Identity Groups.

Nota: all'utente che chiama l'API (o che viene rappresentato da un account di servizio) deve essere assegnato un ruolo che includa le autorizzazioni Gruppi dell'API Admin, 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 groupKey dell'URI della richiesta di gruppo.
email

string

L'indirizzo email del gruppo. Se il tuo account ha più domini, seleziona quello appropriato per l'indirizzo email. Il valore email deve essere univoco. Questa proprietà è obbligatoria durante la creazione di un gruppo. Gli indirizzi email di gruppo sono soggetti alle stesse regole di utilizzo dei caratteri dei nomi utente. Per informazioni dettagliate, 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 unirsi al gruppo, sui tipi di messaggi da inviare al gruppo, sui link alle domande frequenti sul gruppo o sui gruppi correlati. La lunghezza massima è di 4,096 caratteri.
adminCreated

boolean

Sola lettura. Il valore è true se il 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 Gruppi, il valore è admin#directory#group.
etag

string

ETag della risorsa.
aliases[]

string

Sola lettura. L'elenco degli 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 degli indirizzi email degli alias non modificabili del gruppo che non appartengono al dominio principale o ai sottodomini 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 è stato assegnato un userKey (impaginato).

patch

 Aggiorna le proprietà di un gruppo.

update

 Aggiorna le proprietà di un gruppo.