יצירה ועדכון של קבוצה דינמית

בדף הזה מוסבר איך ליצור ולעדכן קבוצה דינמית.

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

לפני שממשיכים לקרוא את המידע בדף הזה, צריך לבצע את המשימות הבאות:

יצירת קבוצה דינמית

הנה דוגמה ליצירת קבוצה דינמית:

REST

כדי ליצור קבוצה דינמית, קוראים ל-groups.create() עם מופע של הקבוצה. המופע של הקבוצה צריך להכיל את התג dynamicGroupMetadata עם השאילתה ששימשה לאכלוס הקבוצה.

Python

כדי ליצור קבוצה דינמית, קוראים ל-method‏ service.groups().create עם מופע של הקבוצה. המופע של הקבוצה צריך להכיל את התג dynamicGroupMetadata עם השאילתה ששימשה לאכלוס הקבוצה. בדוגמה הבאה אפשר לראות איך יוצרים קבוצה דינמית שמכילה את כל המשתמשים שקיימים במחלקת ההנדסה:

def create_dynamic_group(customer_id, email, query):
  service = build_service()
  groupDef = {
      "parent": "customerId/{}".format(customer_id),
      "groupKey": {"id": email},
      "labels": {"cloudidentity.googleapis.com/groups.discussion_forum": ""},
      "dynamicGroupMetadata": {
          "queries": [
              {
                  "resourceType": "USER",
                  "query": "user.organizations.exists(org, org.department=='engineering')"
              }
          ]
      }
  }
  request = service.groups().create(body=groupDef)
  request.uri += "&initialGroupConfig=EMPTY"
  response = request.execute()
  return response

עדכון קבוצה דינמית

דוגמה לעדכון של קבוצה דינמית:

REST

כדי לעדכן קבוצה דינמית, קוראים ל-groups.patch() עם מופע של הקבוצה. המופע של הקבוצה צריך להכיל את התג dynamicGroupMetadata עם השאילתה החדשה שמשמשת לאכלוס הקבוצה.

Python

כדי לעדכן קבוצה דינמית, קוראים לשיטה service.groups().patch עם שם הקבוצה שרוצים לעדכן ועם מופע של הקבוצה. המופע של הקבוצה צריך להכיל את dynamicGroupMetadata עם השאילתה ששימשה לאכלוס הקבוצה. בדוגמה הבאה מוצג איך לעדכן קבוצה דינמית שמכילה את כל המשתמשים במחלקת ההנדסה לקבוצה שמכילה את כל המשתמשים במחלקות ההנדסה או הכספים:

# name (i.e. groups/01234abcdeef) uniquely identifies the group
def update_dynamic_group(name, query):
  service = build_service()
  groupDef = {
    "dynamicGroupMetadata": {
    "queries": [
        {
          "resourceType": "USER",
          "query": "user.organizations.exists(org, org.department=='engineering' || org.department=='finance')"
        }
      ]
    }
  }
  request = service.groups().patch(name=name, body=groupDef)
  request.uri += "&updateMask=dynamicGroupMetadata"
  response = request.execute()

  return response

המאמרים הבאים

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