关联用户数量
目的
获取与每个用户组关联的用户数量。
注意
- 计数包括不活跃/已停用的用户。
端点
- 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 获取帮助。