Zoho crm Logo

将用户类型的用户转移

目的

在门户中将某一用户类型的用户转移到另一用户类型。

端点

  • POST /settings/portals/{portal_name}/user_type/{user_type_id}/users/action/transfer

请求详情

请求 URL

{api-domain}/crm/{version}/settings/portals/{portal_name}/user_type/{user_type_id}/users/action/transfer

标题

授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

scope=ZohoCRM.settings.clientportal.ALL
(或)
scope=ZohoCRM.settings.clientportal.UPDATE

参数
  • transfer_To 必填

    要将用户转移到的用户类型的ID。

  • personality_ids 必填

    要转移到新用户类型的用户的ID,使用逗号分隔。

示例请求

Copiedcurl "https://www.zohoapis.com/crm/v8/settings/portals/ZohoTest17/user_type/1947281000000470169/users/action/transfer?transfer_To=1306462000001857001&personality_ids=1306462000000659009"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-X POST

可能的错误

  • INVALID_DATA HTTP 400
    • 个性 ID 无效。该个性要么不属于任何门户用户,要么不属于此用户类型,或者用户类型无效。
      解决方法:请指定正确的个性 ID。
    • 您正在尝试将用户转移到自定义用户类型。
      解决方法:您只能将用户转移到自定义用户类型。
  • REQUIRED_PARAM_MISSING HTTP 400
    • 您未指定 transfer_To 或 personality_ids。
      解决方法:transfer_To 或 personality_ids 是必填参数。
  • LICENSE_LIMIT_EXCEEDED HTTP 403

    您已超出组织门户的许可证限制。
    解决方法:请联系管理员或support@zohocrm.com购买用户类型附加包。

  • NO_PERMISSION HTTP 403

    “客户门户用户”权限已被禁用。
    解决方法:请联系您的管理员,并设置“客户门户用户”以转移用户。

示例响应

Copied{
    "users": [
        {
            "code": "SUCCESS",
            "details": {
                "personality_id": "1306462000000659009"
            },
            "message": "User has been transferred successfully",
            "status": "success"
        }
    ]
}