Azure AD (Entra ID)

配置事件订阅

如果您已启用事件订阅，请在事件订阅详细信息部分中输入以下值：

1. 输入身份验证详细信息。
   1. 客户端 ID：请求访问令牌时所用的客户端 ID。
   2. 客户端密钥：请求访问令牌时所用的客户端密钥。
   3. 密文版本：选择密文版本。
   4. 客户端状态：包含客户端状态的 Secret Manager 密文。用于更改通知身份验证。
2. Azure 租户：用于访问数据的 Microsoft Online 租户。如果您未指定租户，系统会使用您的默认租户。
3. （可选）如果您希望在后端系统的响应中附加其他信息，请选择启用数据丰富化。

   其他信息特定于您为其配置事件的实体。如需了解详情，请参阅事件通知中的数据丰富化。

4. 选择启用专用连接，以在后端应用与连接之间建立安全连接。如果您选择此选项，则必须在创建连接后执行额外的配置步骤。如需了解详情，请参阅事件订阅的专用连接。
5. 输入死信配置。如果您配置了死信，连接会将未处理的事件写入指定的 Pub/Sub 主题。输入以下详细信息：
   1. 死信项目 ID： 您已配置死信 Pub/Sub 主题的 Google Cloud 项目 ID。
   2. 死信主题： 您要将未处理事件的详细信息写入到的 Pub/Sub 主题。
6. 如果您想使用代理连接到后端（用于订阅活动），请输入以下详细信息：
1. 代理 SSL 类型：连接到代理服务器时使用的 SSL 类型。选择以下任一身份验证类型：
   • 始终：连接始终启用 SSL 以进行事件订阅。
   • 永不：连接未针对事件订阅启用 SSL。
2. 代理身份验证方案：选择要通过代理服务器进行身份验证的身份验证类型。 支持以下身份验证类型：
   • 基本：基本 HTTP 身份验证。
3. 代理用户：输入用于向代理服务器进行身份验证的用户名。
4. 代理密码：选择用户密码的 Secret Manager 密文。
5. 密文版本：选择密文版本。
6. 在代理服务器部分中，输入代理服务器的详细信息。
   1. 点击 + 添加目标，然后选择目标类型作为主机地址。
   2. 输入代理服务器的主机名或 IP 地址，以及代理服务器的端口号。

实体、操作和动作

所有集成连接器都会为所连接应用的对象提供抽象层。您只能通过此抽象访问应用的对象。抽象作为实体、操作和动作向您展示。

• 实体：实体可以被视为连接的应用或服务中的对象或属性集合。不同连接器的实体定义也会有所不同。例如，在数据库连接器中，表是实体；在文件服务器连接器中，文件夹是实体；在消息传递系统连接器中，队列是实体。

  但可能的情况是，连接器不支持或不具有任何实体，在这种情况下，Entities 列表将为空。

• 操作：操作是指您可以对实体执行的操作。您可以对实体执行以下任一操作：
  • 列表
  • 获取
  • 创建
  • 更新
  • 删除

  从可用列表中选择一个实体，系统会生成该实体可用的操作列表。如需了解操作的详细说明，请参阅连接器任务的实体操作。不过，如果连接器不支持任何实体操作，则不支持的操作不会列在 Operations 列表中。

• 动作：动作是可通过连接器接口提供给集成的头等函数。动作可让您对一个或多个实体进行更改，并且动作因连接器而异。通常，操作会包含一些输入参数和一个输出参数。但可能的情况是，连接器不支持任何动作，在这种情况下，Actions 列表将为空。

操作

本部分列出了连接器支持的部分操作。如需了解如何配置操作，请参阅操作示例。

AddGroupMember 操作

此操作可向群组添加成员。

AddGroupMember 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅操作示例。

RemoveGroupMember 操作

此操作会从群组中移除成员。

RemoveGroupMember 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

AddGroupMember（访客账号）操作

此操作可向群组添加成员。

AddGroupMember 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

RemoveGroupMember（访客账号）操作

此操作会从群组中移除成员

RemoveGroupMember 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

AddUserApplicationRoleAssignment 操作

此操作会将用户添加到应用角色分配中。

AddUserApplicationRoleAssignment 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

RemoveUserApplicationRoleAssignment 操作

此操作会从应用角色分配中移除用户。

RemoveUserApplicationRoleAssignment 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

AddGroupApplicationRoleAssignment 操作

此操作会将群组添加到应用角色分配中。/p>

AddGroupApplicationRoleAssignment 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

RemoveGroupApplicationRoleAssignment 操作

此操作会从应用角色分配中移除群组。

RemoveGroupApplicationRoleAssignment 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

ActivateDirectoryRole 操作

此操作会激活目录角色。

ActivateDirectoryRole 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

VerifyDomain 操作

此操作用于验证网域。

VerifyDomain 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

ChangePassword 操作

此操作会更改用户的密码。

ChangePassword 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

ResetPassword 操作

此操作会重置用户的密码。

ResetPassword 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

AssignLicense 操作

此操作会为用户分配许可。

AssignLicense 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

RemoveLicense 操作

此操作会移除分配给用户的许可。

RemoveLicense 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

FetchAdditionalUserFields 操作

此操作会检索必需的属性字段。

FetchAdditionalUserFields 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

AddGroupOwner 操作

此操作可向群组添加所有者。

AddGroupOwner 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

RemoveGroupOwner 操作

此操作会移除群组所有者。

RemoveGroupOwner 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

InviteExternalUser 操作

此操作会邀请外部用户加入组织。

InviteExternalUser 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

AddPhoneAuthenticationMethod 操作

此操作可让用户执行特定任务

AddPhoneAuthenticationMethod 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

RemovePhoneAuthenticationMethod 操作

此操作会移除用户的手机号码身份验证方法。

RemovePhoneAuthenticationMethod 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

UpdatePhoneAuthenticationMethod 操作

此操作会更新用户的手机身份验证方法。

UpdatePhoneAuthenticationMethod 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

AddPrivilegedRole 操作

此操作会为用户添加一个特权角色。

AddPrivilegedRole 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

RemovePrivilegedRole 操作

此操作会移除用户的特权角色。<

RemovePrivilegedRole 操作的输入参数

RetrieveUserPhoto 操作

此操作用于检索用户照片。

RetrieveUserPhoto 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

UpdateUserPhoto 操作

此操作用于更新用户照片。

UpdateUserPhoto 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

RemoveUserPhoto 操作

此操作会移除用户照片。

RemoveUserPhoto 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

AssignManager 操作

此操作可为特定用户分配经理。

AssignManager 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

RemoveManager 操作

此操作会移除分配给用户的经理。

RemoveManager 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

RetrieveManagerChain 操作

此操作用于检索用户的经理。

RetrieveManagerChain 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

AddProfileCardProperty 操作

此操作会为组织添加新的 ProfileCardProperty。

AddProfileCardProperty 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

下表列出了对 profilecardproperties 执行 List 和 Get 操作所需的权限：

下表列出了对 profilecardproperties 执行 Create 操作所需的权限：

RemoveProfileCardProperty 操作

此操作会移除组织的 ProfileCardProperty。

RemoveProfileCardProperty 操作的输入参数

如需查看有关如何配置此操作的示例，请参阅示例。

操作示例

本部分介绍如何在此连接器中执行一些操作。

示例 - AddGroupMember

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 AddGroupMember 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "MemberId": "5408040c-fb7d-4c36-8b67-3b66e9edaad3",
     "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100"
     }
     

此操作会返回 AddGroupMember 的确认消息。如果操作成功，AddGroupMember 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

[{
  "Success": "True"
  }]
  

示例 - RemoveGroupMember

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 RemoveGroupMember 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "MemberId": "5408040c-fb7d-4c36-8b67-3b66e9edaad3",
     "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100"
     }
     

如果操作成功，RemoveGroupMember 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

[{
  "Success": "True"
  }]
  

示例 - AddGroupMember（访客账号）

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 AddGroupMember 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "MemberId": "735fac93-32df-45c9-b6a3-beee95270a6a",
     "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100"
     }
     

如果操作成功，AddGroupMember 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

[{
  "Success": "True"
  }]
  

示例 - RemoveGroupMember（访客账号）

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 RemoveGroupMember 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "MemberId": "735fac93-32df-45c9-b6a3-beee95270a6a",
     "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100"
     }
     

如果操作成功，RemoveGroupMember 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

[{
  "Success": "True"
  }]
  

示例 - AddUserApplicationRoleAssignment

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 AddUserApplicationRoleAssignment 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "UserId": "3558ca6e-2c2e-41d3-a854-bf9249a3c913",
     "ResourceId": "3a914726-ab97-49a0-ab7d-4f742fbc271e",
     "AppRoleId": "820afb79-d975-4da7-8f29-0e2c0cff1217"
     }
     

如果操作成功，AddUserApplicationRoleAssignment 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

[{
  "Success": "True"
  }]
  

示例 - RemoveUserApplicationRoleAssignment

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 RemoveUserApplicationRoleAssignment 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "UserId": "3558ca6e-2c2e-41d3-a854-bf9249a3c913",
     "AppRoleAssignmentId": "bspYNS4s00GoVL-SSaPJE0xC2--0GxxIu8uS4aeindU"
     }
     

如果操作成功，RemoveUserApplicationRoleAssignment 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

[{
  "Success": "True"
  }]
  

示例 - AddGroupApplicationRoleAssignment

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 AddGroupApplicationRoleAssignment 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "ResourceId": "3a914726-ab97-49a0-ab7d-4f742fbc271e",
     "AppRoleId": "820afb79-d975-4da7-8f29-0e2c0cff1217",
     "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100"
     }
     

如果操作成功，AddGroupApplicationRoleAssignment 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

[{
  "Success": "True"
  }]
  

示例 - RemoveGroupApplicationRoleAssignment

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 RemoveGroupApplicationRoleAssignment 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100",
     "AppRoleAssignmentId": "p3luD3g1tEid3t7Pu3uxAMT7DwI3p29HlrxMuZ143eU"
     }
     

如果操作成功，RemoveGroupApplicationRoleAssignment 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

[{
  "Success": "True"
  }]
  

示例 - ActivateDirectoryRole

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 ActivateDirectoryRole 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

    {
     "RoleTemplateId": "f023fd81-a637-4b56-95fd-791ac0226033"
     } 
     

如果操作成功，ActivateDirectoryRole 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

[{
  "id": "c865d9cb-57da-416c-97a3-753e733da678",
  "roleTemplateId": "f023fd81-a637-4b56-95fd-791ac0226033",
  "displayName": "Service Support Administrator",
  "description": "Can read service health information and manage support tickets."
  }]
  

示例 - VerifyDomain

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 VerifyDomain 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "Id": "eternalsolarsolutions.com"
     } 
     

如果操作成功，VerifyDomain 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

[{
  "Success": "True"
  }]
  

示例 - ChangePassword

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 ChangePassword 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "NewPassword": "XXX@9876",
     "CurrentPassword": "XXX@123"
     }
     

如果操作成功，ChangePassword 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

[{
  "Success": "True"
  }]
  

示例 - ResetPassword

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 ResetPassword 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "Password": "XXX@9876",
     "UserId": "3558ca6e-2c2e-41d3-a854-bf9249a3c913"
     }
     

如果操作成功，ResetPassword 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

[{
  "Success": "True"
  }]
  

示例 - AssignLicense

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 AssignLicense 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "UserID": "3558ca6e-2c2e-41d3-a854-bf9249a3c913",
     "UserPrincipalName": "Gcp_test@z8474.onmicrosoft.com",
     "AddLicenseSkuId": "6ec92958-3cc1-49db-95bd-bc6b3798df71"
     }
     

如果操作成功，AssignLicense 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

[{
  "Success": "True"
  }]
  

示例 - RemoveLicense

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 AssignLicense 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "UserID": "3558ca6e-2c2e-41d3-a854-bf9249a3c913",
     "UserPrincipalName": "Gcp_test@z8474.onmicrosoft.com",
     "RemoveLicenses": "6ec92958-3cc1-49db-95bd-bc6b3798df71"
     }
     

如果操作成功，RemoveLicense 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

[{
  "Success": "True"
  }]
  

示例 - FetchAdditionalUserFields

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 FetchAdditionalUserFields 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "UserId": "9630c9d7-cf15-4406-8d21-598e41a058cc"
     } 
     

如果操作成功，FetchAdditionalUserFields 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

[{
    "id": "9630c9d7-cf15-4406-8d21-598e41a058cc",
    "deleteddatetime": null,
    "accountenabled": "true",
    "agegroup": null,
    "businessphones": "",
    "city": null,
    "companyname": null,
    "consentprovidedforminor": null,
    "country": null,
    "createddatetime": "2024-04-12T10:24:42Z",
    "creationtype": null,
    "department": null,
    "displayname": "Azure_AD_Test",
    "employeehiredate": null,
    "employeeid": null,
    "employeeleavedatetime": null,
    "employeetype": null,
    "externaluserstate": null,
    "externaluserstatechangedatetime": null,
    "faxnumber": null,
    "givenname": null,
    "imaddresses": "",
    "isresourceaccount": null,
    "jobtitle": null,
    "lastpasswordchangedatetime": "2024-05-14T05:07:15Z",
    "legalagegroupclassification": null,
    "mail": null,
    "mailnickname": "Azure_AD_Test",
    "mobilephone": null,
    "officelocation": null,
    "onpremisesdistinguishedname": null,
    "onpremisesdomainname": null,
    "onpremisesimmutableid": null,
    "onpremiseslastsyncdatetime": null,
    "onpremisessamaccountname": null,
    "onpremisessecurityidentifier": null,
    "onpremisessyncenabled": null,
    "onpremisesuserprincipalname": null,
    "othermails": "",
    "passwordpolicies": null,
    "postalcode": null,
    "preferreddatalocation": null,
    "preferredlanguage": null,
    "proxyaddresses": "",
    "securityidentifier": "S-1-12-1-2519779799-1141296917-2388205965-3428360257",
    "showinaddresslist": null,
    "signinsessionsvalidfromdatetime": "2024-05-14T05:07:15Z",
    "state": null,
    "streetaddress": null,
    "surname": null,
    "usagelocation": "IN",
    "userprincipalname": "Azure_AD_Test@z8474.onmicrosoft.com",
    "usertype": "Member",
    "aboutme": null,
    "birthday": "0001-01-01T08:00:00Z",
    "hiredate": "0001-01-01T08:00:00Z",
    "interests": "",
    "mysite": null,
    "pastprojects": "",
    "preferredname": "",
    "responsibilities": "",
    "schools": "",
    "skills": "",
    "assignedlicenses": "",
    "assignedplans": "[\r\n  {\r\n    \"assignedDateTime\": \"2024-05-16T10:17:45Z\",\r\n    \"capabilityStatus\": \"Deleted\",\r\n    \"service\": \"DynamicsNAV\",\r\n    \"servicePlanId\": \"3f2afeed-6fb5-4bf9-998f-f2912133aead\"\r\n  }\r\n]",
  "authorizationinfo_certificateuserids": "",
  "identities": "[\r\n  {\r\n    \"signInType\": \"userPrincipalName\",\r\n    \"issuer\": \"z8474.onmicrosoft.com\",\r\n    \"issuerAssignedId\": \"Azure_AD_Test@z8474.onmicrosoft.com\"\r\n  }\r\n]",
  "licenseassignmentstates": "",
  "onpremisesextensionattributes_extensionattribute1": null,
  "onpremisesextensionattributes_extensionattribute2": null,
  "onpremisesextensionattributes_extensionattribute3": null,
  "onpremisesextensionattributes_extensionattribute4": null,
  "onpremisesextensionattributes_extensionattribute5": null,
  "onpremisesextensionattributes_extensionattribute6": null,
  "onpremisesextensionattributes_extensionattribute7": null,
  "onpremisesextensionattributes_extensionattribute8": null,
  "onpremisesextensionattributes_extensionattribute9": null,
  "onpremisesextensionattributes_extensionattribute10": null,
  "onpremisesextensionattributes_extensionattribute11": null,
  "onpremisesextensionattributes_extensionattribute12": null,
  "onpremisesextensionattributes_extensionattribute13": null,
  "onpremisesextensionattributes_extensionattribute14": null,
  "onpremisesextensionattributes_extensionattribute15": null,
  "onpremisesprovisioningerrors": "",
  "provisionedplans": "",
  "serviceprovisioningerrors": "",
  "customsecurityattributes": "{\r\n  \"ConnectorTesting\": {\r\n    \"@odata.type\": \"#microsoft.graph.customSecurityAttributeValue\",\r\n    \"FavouriteSport\": \"cricket\",\r\n    \"FavouriteMovie\": \"3 idiots\"\r\n  }\r\n}",
  "signinactivity_lastsignindatetime": "2024-05-14T07:04:51Z",
  "signinactivity_lastsigninrequestid": "ed35b322-d0d9-4fcb-8e71-f9ee7e065e00",
  "signinactivity_lastnoninteractivesignindatetime": "2024-05-15T09:00:02Z",
  "signinactivity_lastnoninteractivesigninrequestid": "0d4ce88b-710a-440f-a612-f590954d6800",
  "signinactivity_lastsuccessfulsignindatetime": "2024-05-15T06:45:42Z",
  "signinactivity_lastsuccessfulsigninrequestid": "64643e9d-3468-4e4d-b7c3-8bd316956600"
  }  
  

示例 - AddGroupOwner

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 AddGroupOwner 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100",
     "OwnerId": "9630c9d7-cf15-4406-8d21-598e41a058cc"
     }
     

如果操作成功，AddGroupOwner 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

[{
  "Success": "True"
  }]
  

示例 - RemoveGroupOwner

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 RemoveGroupOwner 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100",
     "OwnerId": "9630c9d7-cf15-4406-8d21-598e41a058cc"
     }
     

如果操作成功，RemoveGroupOwner 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

[{
  "Success": "True"
  }]
  

示例 - InviteExternalUser

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 InviteExternalUser 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "UserEmailAddress": "taleprajyot97@gmail.com",
     "RedirectURL": "https://www.example.com"
     }
     

此操作会返回 InviteExternalUser 的确认消息。如果操作成功，InviteExternalUser 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

[{
  "Success": "True",
  "Id": "70905aef-361f-4cb1-8d04-41f9e377ebd3",
  "ReedemURL": "https://login.microsoftonline.com/redeem?rd=https%3a%2f%2finvitations.microsoft.com%2fredeem%2f%3ftenant%3d9b25e811-f983-4982-82e4-263c1ca48112%26user%3d70905aef-361f-4cb1-8d04-41f9e377ebd3%26ticket%3dx5aOZc%25252bE9XslKcOdb101qLnoe2V%25252b8%25252beeFlNhYA5WvTg%25253d%26ver%3d2.0",
  "InvitedUserId": "d5eeb199-a544-4985-b726-e3073751050c"
  }]
  

示例 - AddPhoneAuthenticationMethod

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 AddPhoneAuthenticationMethod 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "PhoneType": "mobile",
     "UserID": "93e42f0d-74d7-445b-b15a-dd6ceb013d81",
     "PhoneNumber": "+91 9898989890"
     }
     

如果操作成功，AddPhoneAuthenticationMethod 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

[{
  "Success": "True"
  }]
  

示例 - RemovePhoneAuthenticationMethod

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 RemovePhoneAuthenticationMethod 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "PhoneType": "mobile",
     "UserID": "93e42f0d-74d7-445b-b15a-dd6ceb013d81",
     "PhoneNumber": "+91 9898989890"
     }
     

如果操作成功，RemovePhoneAuthenticationMethod 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

[{
  "Success": "True"
  }]
  

示例 - UpdatePhoneAuthenticationMethod

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 UpdatePhoneAuthenticationMethod 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "securityComplianceNotificationPhones": "9899999999",
     "securityComplianceNotificationMails": "abc@gmail.com"
     }
     

如果操作成功，UpdatePhoneAuthenticationMethod 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

[{
  "Success": "True"
  }]
  

示例 - AddPrivilegedRole

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 AddPrivilegedRole 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "PrincipalId": "8cbe82b6-0dd5-4f10-bf67-82bf88ac6cb8",
     "RoleDefinitionId": "729827e3-9c14-49f7-bb1b-9608f156bbb8",
     "Justification": "Add Privileged Role",
     "ScheduleInfo": "{\n\"StartDateTime\" : \"2022-09-09T21:31:27.91Z\",\n\"Expiration\"    : {\n\"Type\"        : \"Eligible\"}\n}"
     }
     

如果操作成功，AddPrivilegedRole 任务的 connectorOutputPayload 响应参数的值类似于以下内容：ç

[{
  "Success": "True"
  }]
  

示例 - RemovePrivilegedRole

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 RemovePrivilegedRole 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "PrincipalId": "8cbe82b6-0dd5-4f10-bf67-82bf88ac6cb8",
     "RoleDefinitionId": "729827e3-9c14-49f7-bb1b-9608f156bbb8",
     "Justification": "Removing Privileage Role"
     }
     

如果操作成功，RemovePrivilegedRole 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

[{
  "Success": "True"
  }]
  

示例 - RetrieveUserPhoto

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 RetrieveUserPhoto 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "UserId": "8e22c728-c523-436b-8f46-3b21cc1b5f80"
     } 
     

如果操作成功，RetrieveUserPhoto 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

[{
    "Status": "Success",
    "FileData": "77+9UE5HDQoaCgAAAA1JSERSAAADUgAAAjYIBgAAAFo077+977+9AAAAAXNSR0IA77+977+9HO+/vQAAAARnQU1BAADvv73vv70L77+9YQUAAAAJcEhZcwAADu+/vQAADu+/vQHvv71v77+9ZAAA77+977+9SURBVHhe77+977+9ZXwcV9K+LWlmZCbvv71O77+977+977+9ZO+/vcmG77+9Ge+/vThmZmZm77+9OO+/vcmG77+977+9MTMzM++/vS0z77+977+977+9eu+/ve+/vXTvv71o77+9KAvvv73vv73vv71w77+9DjRO77+977+9Vl3vv70677+9KWsrR2zvv71zEe+/ve+/vUTvv73vv717KGrvv709EO+/ve+/vWjvv71RG01777+977+9Me+/ve+/vWjvv73vv719OmJLyqfZuu+/vRHvv71ZK++/vQ7Uj9iJ77+977+9du+/vUXEslrvv73vv73vv70uzbzvv70pFu+/vUrvv709Yl4P77+9eu+/vSDvv73vv71n77+977+977+9Gu+/ve+/vV3vv71sP2Vm77+977+9be+/vWbvv707RmxV77+9VFvvv70u77+9Fu+/ve+/vdqi77+9aTbvv71N77+977+9Re+/ve+/vWPvv70tYe+/vRXvv73vv70677+9bu+/vTRbS++/ve+/ve+/vWxkP1vvv71FbWt377+977+9LdW277+977+977+977+977+9ae+/ve+/vXvvv73vv73vv70Z77+9Xe+/vSLvv73vv70X77+977+9E++/vT1ob1/vv71+ae+/ve+/vWx3by1P77+9XT3vv71sL++/ve+/ve+/vWbvv73vv73vv71m77+9F+e0s2vvv712dErvv73vv73vv73vv73vv73vv71p77+977+9Le+/vW/vv73vv71oZ0vvv73vv70577+9R3tb77+92b7vv70R77+977+9KmIHKQ/vv73vv73agdapdu+/vU3vv73vv73vv73vv73vv71zXe+/ve+/ve+/ve+/ve+/vRTvv70777+977+977+96pqK77+9LO+/vXN077+9PO+/ve+/ve+/vVp2f++/vdOgNO+/ve+/veyBlO+/ve+/vQdQ77+9cO+/vTc477+9bBDvv71S77+977+977+977+9Zu+/ve+/vW8I77+977+977+9ZQ8paFnvv70LWnxwYe+/ve+/vVEWNBvvv71O77+977+9eQMKW++/vV8x77+977+9FO+/vd6k77+977+9LmHvv70eRS3erQBiG++/vXXvv71DzLI577+9LO+/vT3vv73vv71077+9Ze+/ve+/ve+/vTcebe+/vWbvv73vv71E77+9UEPvv71r77+9NMus77+9Zu+/ve+/vUVsXe+/ve+/ve+/ve+/ve+/vWZr77+9c29qRG0177+9VdWi77+977+9eu+/ve+/ve+/vUlfTe+/ve+/vW/vv73NujVTbX3vv73vv73vv73vv70V77+9He+/ve+/vXUj77+977+9AdeeMe+/ve+/ve+/ve+/ve+/ve+/vQHvv73vv70Y77+9aFcj77+9Y2Pvv700Zjtpb2vvv73vv73vv73vv73ZmHvXnHvvv70Y77+904Lvv73vv70y77+977+9EO+/ve+/vRjvv73vv71077+9dDvbs++/ve+/vXsX4bqU77+9Wu+/vVsH77+977+977+977+9P1vvv73vv70y77+9fO+/ve+/vV8pZd6rJe+/vXvvv70cy6Yef++/ve+/vWXvv71U1LJf77+9Wg3vv73vv71j1otF77+9NO+/ve+/vQTvv73vv70A77+9SO+/vWZHD++/vQ3vv71ta++/ve+/ve+/veO+rmDvv73vv73vv71c77+9cD1+77+9Hu+/ve+/vSpG77+977+9Y++/ve+/vWfvv73vv73vv70zMXvvv73vv73vv73
  ...[too long to view on UI. Please use the API to view the full content.]
  

示例 - UpdateUserPhoto

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 UpdateUserPhoto 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "UserId": "9630c9d7-cf15-4406-8d21-598e41a058cc",
     "Content": "iVBORw0KGgoAAAANSUhEUgAAA1IAAAI2CAIAAADVVi6oAAAgAElEQVR4AZy9d3Rc1dX3r3POHVmWrG6ckIQHN0gCCYEkT/IkJA89lARc1Xsf1ZlR78W2iis4BFuybMAFMMW4qctFknu31XvvzTbu0tx9fmufOzMWJe+b97fWXmede2ekBYs/8sm3bJm1uLAry9jJt2jFq9Khl6XDL0vFr0ilr0pHXlMdf52ee5tdXU5b3diAN50IYHdCyYMINh1FIJpCnJmcRCGFQSqBdDNIJzhp5H4Su5FIx5PYYDzrjaVdcaxRS+qjyWWNdFlHL2jZBR27ECNdiqNX41l9HG1MYI0JtCWBtSTSjiTWnSz1pNCuZNKXKvWl0e4U0p/GhtLZcDodz2QjmWw0i42soiOZdDiDDaXToVQ6ms76k2lvEuuKZ71xbCBJ6o+nA7F0IIb260ifhg5p6EAkHdGycS0bjaJjGjYWxSY17IZOmtCQ61p6P0a6HU1vRtPbsfRePH2QQO8lkXtJdDqN4aRTfRbRryaQQ+Ucqs+mshj9GiqvocpLyKU8h0CueMwmPJtCDoE8CtlMn2cxnWsh51pCnrWca8FzzSHPAtZYyqusIdMG0s15hq2cOkdOniUnW8hxVI5V6WPpdDSd1kn3IsndKPZNOL2hZteD6HgAHfSnff6s1ZM1u9NmD9biKTW500Z3qdGDNnmxFi+pyYO2+7BWL9Lmy9q8WbuP1OHHegJZVwDr8qc9gawvkPYF0cEgOhTMhkPYcKhqIIj2BpP+IDoQQkfD2WgEG4mgY5EqPCPodS27FUfvJ5lPpVnJGVaQbS9n28o5c+V1j+rXzYWN8+RN9vCuLWyep99kL2901G+Yo19rAevw33p6vdX9XPM72Wwiiw2l0v5U1p9Ge1Kk1gRaH8dOR7Ayf/alh2qnk7RjhWrbUmnLO6p332DrX6fZr0iZL7KUF1jCn1TaP86K/P2siN9Zhj43R/1b68DfWPv+ysbrlw5uT9g6L7JducjeeZGjy6J5zo/buyxwdF9g77nIwfcJ+9Bfzo34pX3MMw4Jv7LP/K3tpj/b5L9gu/0Fq89fn130zpzyFXNOONuecZ1z0WtOnd+ctiDrjkCbwTDH4Qjrm9qf3on9yd34H02n/Jc+9TFIf1xOX6hPexwyF0Da49NJj00nPXYndt7tuB9N6hyGImx71datfrOueNHTrtKR5axkmVS2fHaN67wLvovq1c+26f7cl/zqZPbye5u99NuC4JMI2B8LFelwIodffg/qtkBzIbTthI5dvHMP7/4cp+dL3vcVH9jPBw/CUDEfKYPRMj5Wzscq+dgRPirOh5dK8VH5d04YKYVR8YOj5TBSir9kpIwPlcJwKQyXwHAJFwNDxfg4VGx6lAcP8YGHA/0H8bH/EO8Tl76DeOk7CP378Z+wfx/v3wf9+6Dva7kXT+jbB31fQe9X0P0V79mH0/0V71LmS979BXR9bjp59xe86wve+Tl07OWdnxtnL+/cCx2fKcM7PoP2T6H9Uy5OaPuEt38C7Z/wtj3Qsou37sZp2cNb9sgte3gzDjTv4U27efNO3vwxb/4Ip0lM807etBMaP4KGHdCwgzd+iO8bP+SNH0KT4aXhfcN2qC/k9dvlum1Qvw3qxGPdNj5joN74WFsw8z3eDW8KeJ34qLYA3xhHrsuH+nxel89r83ndVsPP1hZA7VbAx628Lh8atvLGfF6/Va4v4LVbceryeaPxfWM+NObzhgLegC+VAeXeUIAX/KgA3xu/gL+wYSv+lGmMH+GbpgLT4HdmPP7f780FvHnrw2nZyvHNNpyWfN4i7k3boLmAt4pp2cZbC7npbNnGWwrxo5Z8aM0X39kGbQWG6djK2/OhrYC35z+cjnxow/e8Ix/E8M4C6MjnnQUPp2sb79qGj8rZOeOufPS9E7rF
     ...[too long to view on UI. Please use the API to view the full content.]
     

如果操作成功，UpdateUserPhoto 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

 [{
  "Status": "Success"
  }]
  

示例 - RemoveUserPhoto

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 RemoveUserPhoto 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

    {
     "UserId": "9630c9d7-cf15-4406-8d21-598e41a058cc"
     } 
     

如果操作成功，RemoveUserPhoto 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

 [{
  "Status": "Success"
  }]
  

示例 - AssignManager

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 AssignManager 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "UserId": "3558ca6e-2c2e-41d3-a854-bf9249a3c913",
     "ObjectId": "8cbe82b6-0dd5-4f10-bf67-82bf88ac6cb8",
     "ObjectName": "users"
     }
     

如果操作成功，AssignManager 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

 [{
  "Status": "True"
  }]
  

示例 - RemoveManager

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 RemoveManager 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "UserId": "3558ca6e-2c2e-41d3-a854-bf9249a3c913"
     } 
     

如果操作成功，RemoveManager 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

 [{
  "Status": "True"
  }]
  

示例 - RetrieveManagerChain

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 RetrieveManagerChain 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
     "UserId": "8cbe82b6-0dd5-4f10-bf67-82bf88ac6cb8",
     "Levels": "max"
     }
     

如果操作成功，RetrieveManagerChain 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

[{
  "id": "8cbe82b6-0dd5-4f10-bf67-82bf88ac6cb8",
  "displayName": "test1",
  "manager": "{\r\n  \"@odata.type\": \"#microsoft.graph.user\",\r\n  \"id\": \"9630c9d7-cf15-4406-8d21-598e41a058cc\",\r\n  \"deletedDateTime\": null,\r\n  \"accountEnabled\": true,\r\n  \"ageGroup\": null,\r\n  \"businessPhones\": [],\r\n  \"city\": null,\r\n  \"companyName\": null,\r\n  \"consentProvidedForMinor\": null,\r\n  \"country\": null,\r\n  \"createdDateTime\": \"2024-04-12T10:24:42Z\",\r\n  \"creationType\": null,\r\n  \"department\": null,\r\n  \"displayName\": \"Azure_AD_Test\",\r\n  \"employeeId\": null,\r\n  \"employeeHireDate\": null,\r\n  \"employeeLeaveDateTime\": null,\r\n  \"employeeType\": null,\r\n  \"externalUserState\": null,\r\n  \"externalUserStateChangeDateTime\": null,\r\n  \"faxNumber\": null,\r\n  \"givenName\": null,\r\n  \"isLicenseReconciliationNeeded\": false,\r\n  \"jobTitle\": null,\r\n  \"legalAgeGroupClassification\": null,\r\n  \"mail\": null,\r\n  \"mailNickname\": \"Azure_AD_Test\",\r\n  \"mobilePhone\": null,\r\n  \"onPremisesDistinguishedName\": null,\r\n  \"onPremisesDomainName\": null,\r\n  \"onPremisesImmutableId\": null,\r\n  \"onPremisesLastSyncDateTime\": null,\r\n  \"onPremisesSecurityIdentifier\": null,\r\n  \"onPremisesSamAccountName\": null,\r\n  \"onPremisesSyncEnabled\": null,\r\n  \"onPremisesUserPrincipalName\": null,\r\n  \"otherMails\": [],\r\n  \"passwordPolicies\": null,\r\n  \"officeLocation\": null,\r\n  \"postalCode\": null,\r\n  \"preferredDataLocation\": null,\r\n  \"preferredLanguage\": null,\r\n  \"proxyAddresses\": [],\r\n  \"refreshTokensValidFromDateTime\": \"2024-05-14T05:07:15Z\",\r\n  \"imAddresses\": [],\r\n  \"isResourceAccount\": null,\r\n  \"showInAddressList\": null,\r\n  \"securityIdentifier\": \"S-1-12-1-2519779799-1141296917-2388205965-3428360257\",\r\n  \"signInSessionsValidFromDateTime\": \"2024-05-14T05:07:15Z\",\r\n  \"state\": null,\r\n  \"streetAddress\": null,\r\n  \"surname\": null,\r\n  \"usageLocat
  ...[too long to view on UI. Please use the API to view the full content.]
  

示例 - AddProfileCardProperty

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 AddProfileCardProperty 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

    {
   "Annotations": "[{"displayName": "Attributes"}]",
   "DirectoryPropertyName": "CustomAttribute15"
   }

如果操作成功，AddProfileCardProperty 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

 [{
"Status": "True"
}]

示例 - RemoveProfileCardProperty

1. 在 Configure connector task 对话框中，点击 Actions。
2. 选择 RemoveProfileCardProperty 操作，然后点击完成。
3. 在连接器任务的任务输入部分中，点击 connectorInputPayload，然后在 Default Value 字段中输入类似于以下内容的值：

   {
   "DirectoryPropertyName": "CustomAttribute12"
   } 

如果操作成功，RemoveProfileCardProperty 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

 [{
"Status": "True"
}]

实体操作示例

本部分介绍如何在此连接器中执行一些实体操作。

示例 - 列出群组

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择“群组”。
3. 选择 LIST 操作，然后点击完成。
4. 连接器任务的任务输入部分中，您可以根据客户要求设置 filterClause。

您必须使用单引号 (') 将过滤条件子句的值括起来。您可以使用过滤条件子句根据列过滤记录。

您还可以对以下实体执行 LIST 操作：

• 用户
• GroupMembers
• 网域
• RoleAssignments
• 应用
• 设备
• 通讯录
• DirectoryRoleTemplates
• DirectoryRoles
• AdministrativeUnits
• SubscribedSKUs
• PhoneAuthenticationMethod
• 组织
• DeviceLocalCredentials
• ProfileCardProperties

示例 - 从群组中获取单个记录

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择“群组”。
3. 选择 GET 操作，然后点击完成。
4. 将实体 ID 设置为“bb4756c7-38c0-426b-97aa-03b6443e7f16”，这是要传递的密钥。如需设置实体 ID，请在数据映射的数据映射器部分中，点击打开数据映射编辑器，然后在输入值字段中输入 "bb4756c7-38c0-426b-97aa-03b6443e7f16"，并选择 EntityId 作为局部变量。

您还可以对以下实体执行 GET 操作：

• 用户
• GroupMembers
• 网域
• RoleAssignments
• 应用
• 设备
• 通讯录
• DirectoryRoleTemplates
• DirectoryRoles
• AdministrativeUnits
• PhoneAuthenticationMethod
• 组织
• UserManagers
• DeviceLocalCredentials

示例 - 从群组中删除记录

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择“群组”。
3. 选择 DELETE 操作，然后点击完成。
4. 将实体 ID 设置为“62008bbe-effa-4341-9d29-eac7f67b84fe”，这是要传递的密钥。如需设置实体 ID，请在数据映射的数据映射器部分中，点击打开数据映射编辑器，然后在输入值字段中输入 "62008bbe-effa-4341-9d29-eac7f67b84fe"，并选择 EntityId 作为局部变量。

   如果存在两个复合键或主键，则传递实体 ID 可能会引发错误。在这种情况下，您可以使用过滤条件子句，例如 id='62008bbe-effa-4341-9d29-eac7f67b84fe'。

您还可以对以下实体执行 DELETE 操作：

示例 - 创建群组 (Microsoft 365) 实体

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择“群组”。
3. 选择 Create 操作，然后点击完成。
4. 在数据映射任务的数据映射器部分中，点击 Open Data Mapping Editor，然后在 Input Value 字段中输入类似于以下内容的值，并选择 EntityId/ConnectorInputPayload 作为局部变量。

   {
   "securityEnabled": true,
   "displayName": "GoogleGCP",
   "description": "This Group is creating for gcp testing.",
   "mailEnabled": false,
   "mailNickname": "GoogleGCP",
   "groupTypes": "Unified"
   }

   此示例会创建 Groups 记录。如果集成成功，Groups 任务的 connectorOutputPayload 响应参数的值类似于以下内容：

   {
   "id": "30fc13b3-79b3-4ac5-a3ba-684d4e887ecc"
   } 

示例 - 更新用户

1. 在 Configure connector task 对话框中，点击 Entities。
2. 从 Entity 列表中选择“用户”。
3. 选择 Update 操作，然后点击完成。
4. 在数据映射任务的数据映射器部分中，点击 Open Data Mapping Editor，然后在 Input Value 字段中输入类似于以下内容的值，并选择 EntityId/ConnectorInputPayload/FilterClause 作为局部变量。

   {
   "jobTitle": "Software Engineer"
   }

5. 在数据映射器中，将实体 ID 设置为“用户”实体。如需设置实体 ID，请点击 Open Data Mapping Editor，然后在 Input Value 字段中输入类似于以下内容的值，并选择 EntityId/ConnectorInputPayload/FilterClause 作为局部变量。

   或者，您也可以将 filterClause 设置为 7ad59ec3-1c37-4932-be51-7513fe98c3c3，而不是指定 entityId。

   此示例会在连接器任务的 connectorOutputPayload 输出变量中返回类似于以下内容的响应：

   {
   "id": "7ad59ec3-1c37-4932-be51-7513fe98c3c3"
   }