--- title: "segments" description: "客户细分列表" doc_type: graphql doc_category: adminGraphQL doc_version: v20270301 source_url: html: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/customers/queries/segments' md: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/customers/queries/segments.md' --- # segments 客户细分列表 - **Required Scopes:** `read_customers` - **API Version:** v20270301 - **API Type:** Admin - **API Protocol:** GraphQL - **Operation Type:** Query ## Type Signature `SegmentConnection` ## Required Permissions * `read_customers` 接口访问需要令牌，具体如何获取令牌请参考：[身份认证](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/graph-ql-admin-api/overview.md) ## Arguments * `first` [Int](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/int.md) 返回列表中的前 n 个元素。 * `last` [Int](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/int.md) 返回列表中的最后 n 个元素。 * `reverse` [Boolean](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/boolean.md) 是否反转列表的顺序。 ● true：反转 ● false：不反转 默认值：false * `sortKey` [SegmentSortKeys](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/customers/enums/segment-sort-keys.md) 按指定键值 排序 * `rawQuery` [String](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md) 查询条件,例如细分名称 * `after` [String](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md) 返回指定游标之后的元素。如果指定了该参数，也必须要指定 `first` 参数。 * `before` [String](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md) 返回指定游标之前的元素。如果指定了该参数，也必须要指定 `last` 参数。 ## Returns * `edges` [[SegmentEdge!]](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/customers/objects/segment-edge.md) edges 列表 * `nodes` [[Segment]](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/customers/objects/segment.md) 节点列表 * `pageInfo` [PageInfo!](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common-objects/objects/page-info.md) 帮助分页的信息 ## Code Example ```graphql { segments(first, last, reverse, sortKey, rawQuery, after, before ) { # SegmentConnection fields } } ``` ## Examples ### 细分列表 查询客户细分列表 **Request:** ```json query { segments (first: 2, rawQuery: null,after:null,before:null,reverse:true,sortKey:LAST_EDIT_DATE) { edges { cursor node { id name query creationDate lastEditDate } } nodes { id name query creationDate lastEditDate } pageInfo { endCursor hasNextPage hasPreviousPage startCursor } } } ``` **Response:** ```json { "data": { "data": { "segments": { "pageInfo": { "endCursor": "AF52536A1951B28A30AAE8825A2B69B9", "hasNextPage": true, "hasPreviousPage": false, "startCursor": "39C77C6A85E202FDAAB6A0D829D4F007" }, "edges": [ { "cursor": "39C77C6A85E202FDAAB6A0D829D4F007", "node": { "creationDate": "2022-09-13T11:20:19.745Z", "id": "gid://shopline/Segment/GROUP5582449353606848831", "lastEditDate": "2023-12-29T12:29:46.589Z", "name": "New", "query": "{\"conditions\":{\"type\":1,\"blockType\":0,\"metafield\":false,\"relation\":\"and\",\"extInfo\":\"{\\\"id\\\":\\\"37a6365b-67bf-4c3e-86c2-f0b086db63db\\\"}\",\"children\":[{\"type\":1,\"blockType\":0,\"metafield\":false,\"relation\":\"and\",\"extInfo\":\"{\\\"id\\\":\\\"26ba86d5-9658-4b2b-beed-7c27612eb7af\\\"}\",\"children\":[{\"type\":0,\"blockType\":0,\"metafield\":false,\"key\":\"payOrderCnt\",\"value\":[1],\"operator\":\"LT\"}]}]},\"not\":{\"type\":1,\"blockType\":0,\"metafield\":false,\"relation\":\"and\",\"extInfo\":\"{\\\"id\\\":\\\"8efe7f6f-96d4-457b-bccb-a5418abc200a\\\"}\",\"children\":[{\"type\":1,\"blockType\":0,\"metafield\":false,\"relation\":\"and\",\"extInfo\":\"{\\\"id\\\":\\\"53f86c31-aebe-4fab-9f20-b9f6f150322c\\\"}\",\"children\":[]}]}}" } }, { "cursor": "AF52536A1951B28A30AAE8825A2B69B9", "node": { "creationDate": "2022-09-13T11:20:19.762Z", "id": "gid://shopline/Segment/GROUP5582449353892061504", "lastEditDate": "2023-12-29T12:29:46.589Z", "name": "Returning", "query": "{\"conditions\":{\"type\":1,\"blockType\":0,\"metafield\":false,\"relation\":\"and\",\"extInfo\":\"{\\\"id\\\":\\\"2ddd694c-43bf-4e51-8267-e81ae609f748\\\"}\",\"children\":[{\"type\":1,\"blockType\":0,\"metafield\":false,\"relation\":\"and\",\"extInfo\":\"{\\\"id\\\":\\\"556149a7-de15-4525-83c8-14079adc017d\\\"}\",\"children\":[{\"type\":0,\"blockType\":0,\"metafield\":false,\"key\":\"payOrderCnt\",\"value\":[1],\"operator\":\"GT\"}]}]},\"not\":{\"type\":1,\"blockType\":0,\"metafield\":false,\"relation\":\"and\",\"extInfo\":\"{\\\"id\\\":\\\"65b327aa-e627-4df7-8276-af7649cade78\\\"}\",\"children\":[{\"type\":1,\"blockType\":0,\"metafield\":false,\"relation\":\"and\",\"extInfo\":\"{\\\"id\\\":\\\"9adf2014-c753-4b68-b247-201f35ba98db\\\"}\",\"children\":[]}]}}" } } ], "nodes": [ { "lastEditDate": "2023-12-29T12:29:46.589Z", "name": "New", "query": "{\"conditions\":{\"type\":1,\"blockType\":0,\"metafield\":false,\"relation\":\"and\",\"extInfo\":\"{\\\"id\\\":\\\"37a6365b-67bf-4c3e-86c2-f0b086db63db\\\"}\",\"children\":[{\"type\":1,\"blockType\":0,\"metafield\":false,\"relation\":\"and\",\"extInfo\":\"{\\\"id\\\":\\\"26ba86d5-9658-4b2b-beed-7c27612eb7af\\\"}\",\"children\":[{\"type\":0,\"blockType\":0,\"metafield\":false,\"key\":\"payOrderCnt\",\"value\":[1],\"operator\":\"LT\"}]}]},\"not\":{\"type\":1,\"blockType\":0,\"metafield\":false,\"relation\":\"and\",\"extInfo\":\"{\\\"id\\\":\\\"8efe7f6f-96d4-457b-bccb-a5418abc200a\\\"}\",\"children\":[{\"type\":1,\"blockType\":0,\"metafield\":false,\"relation\":\"and\",\"extInfo\":\"{\\\"id\\\":\\\"53f86c31-aebe-4fab-9f20-b9f6f150322c\\\"}\",\"children\":[]}]}}", "creationDate": "2022-09-13T11:20:19.745Z", "id": "gid://shopline/Segment/GROUP5582449353606848831" }, { "query": "{\"conditions\":{\"type\":1,\"blockType\":0,\"metafield\":false,\"relation\":\"and\",\"extInfo\":\"{\\\"id\\\":\\\"2ddd694c-43bf-4e51-8267-e81ae609f748\\\"}\",\"children\":[{\"type\":1,\"blockType\":0,\"metafield\":false,\"relation\":\"and\",\"extInfo\":\"{\\\"id\\\":\\\"556149a7-de15-4525-83c8-14079adc017d\\\"}\",\"children\":[{\"type\":0,\"blockType\":0,\"metafield\":false,\"key\":\"payOrderCnt\",\"value\":[1],\"operator\":\"GT\"}]}]},\"not\":{\"type\":1,\"blockType\":0,\"metafield\":false,\"relation\":\"and\",\"extInfo\":\"{\\\"id\\\":\\\"65b327aa-e627-4df7-8276-af7649cade78\\\"}\",\"children\":[{\"type\":1,\"blockType\":0,\"metafield\":false,\"relation\":\"and\",\"extInfo\":\"{\\\"id\\\":\\\"9adf2014-c753-4b68-b247-201f35ba98db\\\"}\",\"children\":[]}]}}", "creationDate": "2022-09-13T11:20:19.762Z", "id": "gid://shopline/Segment/GROUP5582449353892061504", "lastEditDate": "2023-12-29T12:29:46.589Z", "name": "Returning" } ] } } } } ``` ## Error Handling 关于更多通用错误码说明，参考：[状态码和错误码](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/graph-ql-admin-api/overview.md#status-and-error-codes)。