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.