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 ricevute dai 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'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 includere brevemente una persona in un gruppo di team per 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 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'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. Al momento, 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 dal momento in cui viene 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.