Gestione delle scadenze delle iscrizioni

Questa pagina spiega come aggiornare e recuperare le impostazioni di scadenza per le iscrizioni ai gruppi e le notifiche di scadenza che ricevono i proprietari dei gruppi.

La scadenza dell'abbonamento consente ai proprietari di gruppi, ai gestori di gruppi, ai super amministratori di Google Workspace o agli amministratori delegati di Workspace con privilegi di amministratore di gruppo di gestire i gruppi e l'accesso alle risorse in base ai gruppi. L'accesso può essere limitato in base al mancato aggiornamento delle iscrizioni o a necessità temporanee senza rimuovere manualmente i membri. L'API Groups consente la scadenza dell'iscrizione per i seguenti casi d'uso:

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

Le scadenze possono essere applicate a tutti i tipi di membri del gruppo (inclusi utenti, gruppi e account di servizio) se dispongono di un ruolo MEMBER. Quando imposti una scadenza per un membro che è un gruppo, questa diventa la scadenza predefinita per tutti i membri secondari del 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. Per scoprire come, consulta Configurazione dell'API Cloud Identity Groups.

Aggiunta di un abbonamento con scadenza

Per scoprire come, consulta Gestire le appartenenze ai gruppi Google per Google Gruppi o Gestire le appartenenze ai gruppi con mappatura delle identità.

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'abbonamento e una risorsa UpdateMembershipRolesParams. Poiché i membri possono avere più di un MembershipRole in un gruppo, devi specificare il ruolo che avrà la scadenza. Al momento, solo al ruolo MEMBER può essere applicata una scadenza.

Corpo della richiesta di esempio

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

Recupero della scadenza di un abbonamento

Per recuperare la data di scadenza di un abbonamento, chiama groups.memberships.get() con l'ID del gruppo principale e l'ID dell'abbonamento.

Notifiche via email

Le notifiche via email vengono inviate automaticamente a tutti i proprietari del gruppo quando gli abbonamenti stanno per scadere. Le notifiche vengono inviate 72 ore prima della scadenza o immediatamente se l'abbonamento scade prima di 72 ore dal momento dell'impostazione. 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.