Gestione delle scadenze delle appartenenze ai gruppi
In questa pagina viene spiegato come aggiornare e recuperare le impostazioni di scadenza per il gruppo iscrizioni e le notifiche di scadenza che ricevono i proprietari dei gruppi.
La scadenza dell'iscrizione consente a proprietari di gruppi, gestori di gruppi, Google Workspace Super amministratori o amministratori con delega di amministratore di Workspace con privilegi di amministratore di gruppo per gestire gruppi e l'accesso basato su gruppi alle risorse. L'accesso può essere limitato in base problemi di mancato aggiornamento degli abbonamenti o necessità temporanee senza rimuovere manualmente i membri. L'API Groups consente la scadenza dell'appartenenza per i seguenti casi d'uso:
- Accesso alle risorse a tempo limitato (ad esempio, per consentire a qualcuno di aiutarti risolvere un problema in produzione)
- Iscrizione temporanea a un gruppo di comunicazione (ad esempio, per brevi includi una persona in un gruppo di team su un progetto a lungo termine)
È possibile applicare scadenze a tutti i tipi di membri del gruppo (inclusi utenti,
gruppi e account di servizio) se hanno un ruolo MEMBER
. Quando imposti
scadenza per un membro di un gruppo, diventa l'impostazione predefinita
scadenza per tutti i membri secondari di quel gruppo, a meno che il membro secondario non abbia
appartenenza diretta al gruppo principale con già una scadenza individuale
applicati. La scadenza si applica anche a tutti i nuovi membri del gruppo secondario
in futuro.
Prima di iniziare
Configura l'autenticazione e installa le librerie client. Consulta: Configura l'API Cloud Identity Groups per scopri come.
Aggiunta di un'iscrizione con scadenza
Consulta: Gestire le iscrizioni ai gruppi Google per Google Gruppi o Gestione delle iscrizioni ai gruppi con mappatura delle identità per scoprire come.
Aggiornare la scadenza di un abbonamento
Per aggiornare la scadenza di un abbonamento, chiama
groups.memberships.modifyMembershipRoles()
con l'ID del gruppo principale, l'ID dell'appartenenza e un
UpdateMembershipRolesParams
risorsa. Perché i membri possono avere più di un MembershipRole
in un gruppo, devi specificare quale ruolo avrà la scadenza. Attuale
solo al ruolo MEMBER
può essere applicata una scadenza.
Esempio di corpo della richiesta
{
"updateRolesParams": [
{
"fieldMask": "expiry_detail.expire_time",
"membershipRole": {
"expiryDetail": {
"expireTime": "2021-10-02T15:01:23Z"
},
"name": "MEMBER"
}
}
]
}
Recupero della scadenza di un'appartenenza
Per recuperare la scadenza di un'appartenenza, chiama
groups.memberships.get()
con l'ID del gruppo principale e l'ID dell'appartenenza.
Notifiche via email
Le notifiche via email vengono inviate automaticamente a tutti i proprietari dei gruppi quando sono iscritti. stanno per scadere. Le notifiche vengono inviate 72 ore prima della scadenza o immediatamente se l'abbonamento scade prima di 72 ore quando è impostato. Le notifiche vengono inviate nella lingua preferita di ciascun proprietario del gruppo, come definito dall'amministratore del dominio nella Console di amministrazione Google o dal proprietario del gruppo singolarmente.