Gestione delle scadenze delle iscrizioni

In questa pagina viene spiegato come aggiornare e recuperare le impostazioni di scadenza per i membri dei gruppi, nonché le notifiche di scadenza ricevute dai proprietari dei gruppi.

La scadenza dell'iscrizione consente ai proprietari e ai gestori dei gruppi, ai super amministratori di Google Workspace o agli utenti con delega di amministratore di Workspace con privilegi di amministratore del gruppo di gestire i gruppi e l'accesso alle risorse basato sui gruppi. L'accesso può essere limitato in base all'inattività dell'abbonamento o a esigenze temporanee senza dover rimuovere manualmente i membri. L'API Groups consente la scadenza dell'iscrizione per i seguenti casi d'uso:

  • Accesso limitato nel tempo alle risorse (ad esempio, per consentire a qualcuno di aiutarti a risolvere un problema in produzione)
  • Appartenenza temporanea a un gruppo di comunicazione (ad esempio, per includere brevemente una persona in un gruppo di team in un progetto a lungo termine)

È possibile applicare scadenze a tutti i tipi di membri dei gruppi (inclusi utenti, gruppi e account di servizio) se hanno un ruolo MEMBER. Quando imposti una scadenza per un membro che è un gruppo, tale scadenza diventa la scadenza predefinita per tutti i membri secondari di quel gruppo, a meno che il membro secondario non abbia un'appartenenza diretta al gruppo principale con una scadenza individuale già applicata. 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 Configurazione dell'API Cloud Identity Groups per ulteriori informazioni.

Aggiunta di un'iscrizione con scadenza

Per ulteriori informazioni, vedi Gestire le iscrizioni ai gruppi Google per Google Gruppi o Gestire le iscrizioni ai gruppi con mappatura delle identità per ulteriori informazioni.

Aggiornare la scadenza di un'iscrizione

Per aggiornare la scadenza di un'iscrizione, chiama groups.memberships.modifyMembershipRoles() con l'ID del gruppo principale, l'ID dell'appartenenza e una risorsa UpdateMembershipRolesParams. Poiché i membri possono avere più di un elemento MembershipRole in un gruppo, devi specificare quale ruolo avrà la scadenza. Al momento è possibile che al ruolo MEMBER sia applicata una scadenza.

Esempio di corpo della richiesta

{
  "updateRolesParams": [
    {
      "fieldMask": "expiry_detail.expire_time",
      "membershipRole": {
        "expiryDetail": {
          "expireTime": "2021-10-02T15:01:23Z"
        },
        "name": "MEMBER"
      }
    }
  ]
}

Recuperare la scadenza di un'iscrizione

Per recuperare la scadenza dell'iscrizione per un determinato gruppo, 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 le iscrizioni stanno per scadere. Le notifiche vengono inviate 72 ore prima della scadenza o immediatamente se l'abbonamento scadrà prima di 72 ore quando viene impostato. Le notifiche vengono inviate nella lingua preferita di ciascun proprietario del gruppo, come definita dall'amministratore del dominio nella Console di amministrazione Google o dal singolo proprietario del gruppo.