客户保存的搜索
客户保存的搜索是代表店主定义的一组客户的搜索查询。
在Shopify管理员中，商店所有者通过输入查询并应用一个或多个过滤器来搜索客户。返回结果后，店主可以保存搜索并为其命名。创建客户保存的搜索后，商店所有者可以在以后选择它，以查看与查询匹配的客户列表。
客户保存的搜索查询
使用下表构造客户搜索查询：
| API值 | 管理员界面值 | 描述 |
|---|---|---|
accepts_marketing |
接受营销 | 根据客户是否接受电子邮件营销来对其进行过滤。有效值： + 0：返回不接受电子邮件营销的客户。 + 1：返回接受电子邮件营销的客户。 |
country |
位于 | 检索来自指定国家/地区的客户。有效值是任何国家/地区的全引号。值示例： + \“美国\”：仅返回来自美国的客户。双引号已被转义。 + ‘加拿大’：仅返回来自加拿大的客户。 |
customer_date |
创建日期 | 检索在一定时间内创建的客户。有效值： + past_week：返回上周创建的客户。 + past_month：返回上个月创建的客户。 + last_3_months：返回最近3个月内创建的客户。 + past_quarter：返回上一个季度创建的客户。 + past_year：返回上一年创建的客户。 + yyyy-md：返回在指定日期创建的客户。 + > yyyy-md：返回在指定日期之后创建的客户。 + <yyyy-md：返回在指定日期之前创建的客户。 |
last_abandoned_order_date |
放弃订单 | 检索在一定时间内放弃了购物车的客户。有效值： + last_week：返回上周放弃购物车的客户。 + last_month：返回上个月放弃购物车的客户。 |
order_date |
下订单 | 检索在指定时间段内下订单的客户。有效值： + last_week：返回上周下订单的客户。 + last_month：返回上个月下订单的客户。 + last_3_months：返回最近3个月内下订单的客户。 + last_year：返回上一年下订单的客户。 + > yyyy-md：返回在指定日期之后下订单的客户。 + <yyyy-md：返回在指定日期之前下订单的客户。 |
orders_count |
下订单 | 按客户在商店中下达的订单数过滤客户。有效值： + > number_of_orders：返回下达少于指定数量的订单的客户。 + <number_of_orders：返回已下达指定数量以上订单的客户。 + number_of_orders：返回已下达指定数量订单的客户。 |
state |
帐户状态 | 按客户帐户状态过滤客户。有效值： + 拒绝：返回受邀创建帐户但拒绝的客户。 + 禁用：返回禁用了帐户的客户。 + 已启用：返回拥有客户帐户的客户。 + 受邀：返回受邀创建帐户的客户。 |
tag |
标记为 | 按标签过滤客户。有效值是引号中包含的任何现有客户标签。值示例： + \“大富豪\”：谁都有标签回报客户大富豪。双引号已被转义。 + ‘收藏夹’：返回带有标签收藏夹的顾客。 |
total_spent |
花的钱 | 按客户在所有订单上花费的总金额过滤客户。有效值： + > money_amount：返回消费少于指定金额的客户。 + <money_amount：返回花费超过指定金额的客户。 + money_amount：返回已花费指定金额的客户。 |
使用CustomerSavedSearch可以做什么
Shopify API使您可以使用CustomerSavedSearch资源执行以下操作。这些常规操作的更详细的版本可能可用：
- GET /admin/api/2021-01/customer_saved_searches.json检索客户保存的搜索列表
- GET /admin/api/2021-01/customer_saved_searches/count.json检索所有客户保存的搜索的计数
- GET /admin/api/2021-01/customer_saved_searches/{customer_saved_search_id}.json检索单个客户保存的搜索
- GET /admin/api/2021-01/customer_saved_searches/{customer_saved_search_id}/customers.json检索由客户保存的搜索返回的所有客户
- POST /admin/api/2021-01/customer_saved_searches.json创建客户保存的搜索
- PUT /admin/api/2021-01/customer_saved_searches/{customer_saved_search_id}.json更新客户保存的搜索
- 删除/admin/api/2021-01/customer_saved_searches/{customer_saved_search_id}.json删除客户保存的搜索
CustomerSavedSearch属性
| created_at 只读 | plain "created_at": "2012-08-17T10:01:46-04:00" 创建客户保存的搜索的日期和时间（ISO 8601格式）。 |
|---|---|
| ID 只读 | plain "id": 789629109 客户保存的搜索的唯一标识符。 |
| 姓名 | plain "name": "Accepts Marketing" 商店所有者给客户保存的搜索的名称。 |
| 询问 | plain "query": "accepts_marketing:1" 这组条件决定了保存的搜索返回哪些客户。有关更多信息，请参阅客户保存的搜索查询。 |
| Updated_at 只读 | plain "updated_at": "2012-08-17T10:01:46-04:00" 客户保存的搜索的上次修改日期和时间（ISO 8601格式）。 |
终点
得到/admin/api/2021-01/customer_saved_searches.json 检索客户保存的搜索列表。注意：从2019-07版本开始，此端点通过使用响应标头中提供的链接来实现分页。发送<font style="background-color:#F4F6F8;">page</font>参数将返回错误。要了解更多信息，请参阅向分页的REST Admin API端点发出请求。
| 限制 | 要显示的最大结果数。 （默认值： 50最大： 250） |
|---|---|
| since_id | 将结果限制为指定的ID之后。 |
| 领域 | 仅显示某些字段，这些字段由逗号分隔的字段名称列表指定。 |
检索所有客户保存的商店搜索
GET /admin/api/2021-01/customer_saved_searches.json
在指定的ID之后检索所有客户保存的商店搜索
GET /admin/api/2021-01/customer_saved_searches.json?since_id=20610973
得到/admin/api/2021-01/customer_saved_searches/count.json 检索所有客户保存的搜索的计数。| since_id | 将结果限制为指定的ID之后 |
|---|---|
检索所有客户保存的搜索计数
GET /admin/api/2021-01/customer_saved_searches/count.json
在指定ID后检索所有客户保存的搜索的计数
GET /admin/api/2021-01/customer_saved_searches/count.json?since_id=20610973
得到/admin/api/2021-01/customer_saved_searches/{customer_saved_search_id}.json 检索单个客户保存的搜索。| 领域 | 仅显示某些字段，这些字段由逗号分隔的字段名称列表指定。 |
|---|---|
通过ID获得一个客户保存的搜索
GET /admin/api/2021-01/customer_saved_searches/789629109.json
得到/admin/api/2021-01/customer_saved_searches/{customer_saved_search_id}/customers.json 检索由客户保存的搜索返回的所有客户。| 命令 | 设置排序结果的场和方向。 （默认值： last_order_date DESC） |
|---|---|
| 限制 | 要显示的最大结果数。 （默认值： 50最大： 250） |
| 领域 | 仅显示某些字段，这些字段由逗号分隔的字段名称列表指定。 |
检索与查询匹配的客户，以指定的客户保存的搜索
GET /admin/api/2021-01/customer_saved_searches/789629109/customers.json
邮政/admin/api/2021-01/customer_saved_searches.json 创建客户保存的搜索。创建客户保存的搜索
POST /admin/api/2021-01/customer_saved_searches.json
{
“ customer_saved_search” ： {
“名称” ：“花费超过$ 50”，“ query” ：“总花费：> 50”
}
}
创建包含多个字词的客户保存的搜索
POST /admin/api/2021-01/customer_saved_searches.json
{
“ customer_saved_search” ： {
“名称” ：“花费超过$ 50且在2013年后”，“ query” ：“总共花费：> 50个订购日期：> = 2013-01-01”
}
}
创建没有名称的客户保存的搜索失败并返回错误
POST /admin/api/2021-01/customer_saved_searches.json
{
“ customer_saved_search” ： {
“ body” ：“ foobar”
}
}
放/admin/api/2021-01/customer_saved_searches/{customer_saved_search_id}.json 更新客户保存的搜索。更新现有客户保存的搜索
PUT /admin/api/2021-01/customer_saved_searches/789629109.json
{
“ customer_saved_search” ： {
“ id” ：789629109，“ name” ：“此名称已更改”
}
}
删除/admin/api/2021-01/customer_saved_searches/{customer_saved_search_id}.json 删除客户保存的搜索。删除现有的客户保存的搜索
删除/admin/api/2021-01/customer_saved_searches/789629109.json
若有收获，就点个赞吧
0 人点赞
