管理 Google 群组的成员资格

群组存在后,可以为它创建成员资格。本页面介绍了如何使用 Cloud Identity Groups API 执行一些基本成员资格操作。如需了解如何创建 Google 群组,请参阅创建和搜索 Google 群组

准备工作

设置身份验证并安装客户端库。请参阅设置 Cloud Identity Groups API,了解具体方式。

向 Google 群组添加成员资格

REST

如需将成员添加到 Google 群组,请使用父群组 ID 和成员资格资源调用 groups.memberships.create()expiryDetail 是可选字段,可添加以设置成员资格的到期时间。

请求正文示例

{
  "preferredMemberKey": {
    "id": "techwriter@example.com"
  },
  "roles": [
    {
      "expiryDetail": {
        "expireTime": "2021-10-02T15:01:23Z"
      },
      "name": "MEMBER"
    }
  ]
}

Python

以下代码展示如何向群组添加成员资格。expiryDetail 是可选字段,可添加以设置成员资格的到期时间。preferredMemberKey 的值是成员的电子邮件地址。

def create_google_group_membership(service, identity_source_id, group_id, member_key):
  param = "&groupKey.id=" + group_id + "&groupKey.namespace=identitysources/" + identity_source_id
  try:
    lookupGroupNameRequest = service.groups().lookup()
    lookupGroupNameRequest.uri += param
    # Given a group ID and namespace, retrieve the ID for parent group
    lookupGroupNameResponse = lookupGroupNameRequest.execute()
    groupName = lookupGroupNameResponse.get("name")
    # Create a membership object with a memberKey and a single role of type MEMBER
    membership = {
      "preferredMemberKey": member_key,
      "roles" : {
        "name" : "MEMBER",
        "expiryDetail": {
          "expireTime": "2021-10-02T15:01:23Z"
        }
      }
    }
    # Create a membership using the ID for the parent group and a membership object
    response = service.groups().memberships().create(parent=groupName, body=membership).execute()
    print response
  except Exception, e:
    print e

列出 Google 群组的成员资格

REST

如需列出 Google 群组的成员,请使用父级群组 ID 和成员资格资源调用 groups.memberships.list()

Python

以下代码列出群组的成员资格:

def list_google_group_memberships(service, group_id):
  param = "&groupKey.id=" + group_id
  try:
    lookup_group_name_request = service.groups().lookup()
    lookup_group_name_request.uri += param
    lookup_group_name_response = lookup_group_name_request.execute()
    group_name = lookup_group_name_response.get("name")
    # List memberships
    response = service.groups().memberships().list(parent=group_name).execute()
    print response
  except Exception, e:
    print e