Zoho crm Logo

关联用户数量

目的

获取与每个用户组关联的用户数量。

注意

  • 计数包括不活跃/已停用的用户。

端点

  • GET /settings/user_groups/actions/associated_users_count

Request详情

Request URL

{api-domain}/crm/{version}/settings/user_groups/actions/associated_users_count

标题

授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

scope=ZohoCRM.settings.user_groups.ALL
(或)
scope=ZohoCRM.settings.user_groups.READ

参数

  • page整数,可选

    您想要获取记录的页码。默认值为1。

  • per_page整数,可选

    您想要每页获取的记录数。您可以选择1到200之间的值。默认值和最大值都是200。

  • filtersJSON 对象(编码),可选

    您想要根据哪些条件过滤响应。您可以根据用户组的名称和描述来过滤响应。允许的比较器有 starts_with 和 equal。您也可以有多个条件。详细信息请参考样本请求。
    注意:您必须对请求中的 filters 参数的值进行编码。

样本请求

Response JSON

  • user_group

    用户所属的用户组的名称和ID。

  • 计数

    这个用户组中的用户数量。

  • 信息

    包含以下详细信息:

    • per_page - 每次API调用可以获取的最大记录数。该值为200。
    • page - 当前API调用中获取记录的页码。
    • count - 在API调用中获取的记录数。
    • more_records - 表示是否还有更多的记录可以获取。

可能的错误

  • NO_CONTENTHTTP 204

    没有用户组。
    解决方案:在尝试此API之前,创建一个用户组并将用户关联到它。

  • INVALID_DATAHTTP 400

    "filters"参数的JSON结构无效。
    解决方案:为"filters"参数提供有效的JSON并对值进行编码。

  • OAUTH_SCOPE_MISMATCHHTTP 401

    您没有正确的范围来访问此API。
    解决方案:创建一个带有"Scopes"部分中提到的范围的新令牌,并尝试此API。

  • INACTIVE_USERHTTP 403

    非活跃用户无法访问此API。
    解决方案:只有活跃用户才能访问此API。

  • INTERNAL_SERVER_ERRORHTTP 500

    服务器中未处理和意外的异常。
    解决方案:联系 support@zohocrm.com 获取帮助。

样本回应