---
title: "customerMergePreview"
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/customer-merge-preview'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/customers/queries/customer-merge-preview.md'
---
# customerMergePreview

返回客户合并预览

- **Required Scopes:** `read_customers`
- **API Version:** v20270301
- **API Type:** Admin
- **API Protocol:** GraphQL
- **Operation Type:** Query

## Type Signature

`CustomerMergePreview`

## Required Permissions

* `read_customers`

接口访问需要令牌，具体如何获取令牌请参考：[身份认证](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/graph-ql-admin-api/overview.md)

## Arguments

* `customerOneId`

  [ID](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/id.md)

  被合并时覆盖的客户的ID

* `customerTwoId`

  [ID](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/id.md)

  被合并时保留的客户的ID

* `overrideFields`

  [CustomerMergeOverrideFieldsInput](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/customers/inputs/customer-merge-override-fields-input.md)

  用于覆盖默认客户合并规则的字段

## Returns

* `alternateFields`

  [CustomerMergePreviewAlternateFields](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/customers/objects/customer-merge-preview-alternate-fields.md)

  客户合并后将被覆盖的默认字段

* `blockingFields`

  [CustomerMergePreviewBlockingFields](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/customers/objects/customer-merge-preview-blocking-fields.md)

  客户合并预览的可能被截取字段。除非编辑，否则这些字段在客户合并会自动截取，保留限制的字符

* `customerMergeErrors`

  [[CustomerMergeError]](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/customers/objects/customer-merge-error.md)

  阻止客户合并的错误

* `defaultFields`

  [CustomerMergePreviewDefaultFields](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/customers/objects/customer-merge-preview-default-fields.md)

  两个客户合并后保留的字段

* `resultingCustomerId`

  [ID](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/id.md)

  两个客户合并后客户ID

## Code Example

```graphql
 {
	customerMergePreview(customerOneId, customerTwoId, overrideFields ) 
		 {
			# CustomerMergePreview fields
		}
}
```

## 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)。