ניהול תפוגות של מינויים

בדף הזה מוסבר איך לעדכן ולאחזר את הגדרות התפוגה של חברות בקבוצות, וגם את ההתראות על התפוגה שבעלי הקבוצות מקבלים.

תפוגת החברות מאפשרת לבעלים של קבוצות, למנהלים של קבוצות, לאדמינים ראשיים ב-Google Workspace או לאדמינים מורשים ב-Workspace עם הרשאות אדמין בקבוצה, לנהל קבוצות וגישה למשאבים על בסיס קבוצות. אפשר להגביל את הגישה על סמך משך הזמן שחלף מאז שהמשתמש הצטרף לקבוצה או על סמך צורך זמני, בלי להסיר את המשתמשים באופן ידני. ה-Groups API מאפשר להגדיר תוקף לחברות בתרחישי השימוש הבאים:

• גישה מוגבלת בזמן למשאבים (לדוגמה, כדי לאפשר למישהו לעזור בפתרון בעיה בסביבת הייצור)
• חברות זמנית בקבוצת תקשורת (לדוגמה, כדי לכלול אדם בקבוצת צוות בפרויקט ארוך טווח לזמן קצר)

אפשר להגדיר תאריכי תפוגה לכל סוגי החברים בקבוצה (כולל משתמשים, קבוצות וחשבונות שירות) אם יש להם תפקיד MEMBER. כשמגדירים תאריך תפוגה לחבר שהוא קבוצה, תאריך התפוגה הזה הופך לתאריך התפוגה שמוגדר כברירת מחדל לכל החברים בתת-הקבוצה, אלא אם לחבר בתת-הקבוצה יש חברות ישירה בקבוצת ההורה עם תאריך תפוגה אישי שכבר הוגדר. תאריך התפוגה רלוונטי גם לכל החברים החדשים בתת-הקבוצה מעכשיו והלאה.

לפני שמתחילים

מגדירים אימות ומתקינים את ספריות הלקוח. הוראות מפורטות מופיעות במאמר בנושא הגדרת Cloud Identity Groups API.

הוספת כרטיס מועדון עם תאריך תפוגה

במאמרים ניהול חברויות בקבוצות Google וניהול חברויות בקבוצות שממופות לזהויות מוסבר איך עושים את זה.

עדכון תאריך התפוגה של מינוי

כדי לעדכן את תאריך התפוגה של המינוי, צריך לבצע קריאה ל-method‏ groups.memberships.modifyMembershipRoles() עם המזהה של קבוצת ההורים, המזהה של המינוי ומשאב UpdateMembershipRolesParams. חברים בקבוצה יכולים לקבל יותר מ-MembershipRole, ולכן צריך לציין לאיזה תפקיד יוגדר תאריך התפוגה. נכון לעכשיו, אפשר להגדיר תאריך תפוגה רק לתפקיד MEMBER.

גוף בקשה לדוגמה

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

אחזור של תפוגת מינוי

כדי לאחזר את תאריך התפוגה של המינוי, צריך לבצע קריאה ל-method‏ groups.memberships.get() עם מזהה קבוצת האב ומזהה המינוי.

התראות באימייל

התראות באימייל נשלחות אוטומטית לכל בעלי הקבוצה כשהמינויים עומדים לפוג. ההתראות נשלחות 72 שעות לפני שהמינוי יפוג, או באופן מיידי אם המינוי יפוג לפני שיחלפו 72 שעות מהרגע שבו הוא הוגדר. ההתראות נשלחות בשפה המועדפת של כל בעלי הקבוצה, כפי שהוגדרה על ידי אדמין הדומיין במסוף Google Admin או על ידי בעלי הקבוצה באופן פרטני.