---
title: "collectionAddProducts"
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/products-and-collections/mutations/collection-add-products'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/products-and-collections/mutations/collection-add-products.md'
---
# collectionAddProducts

将一批产品添加到分类中

- **API Version:** v20270301
- **API Type:** Admin
- **API Protocol:** GraphQL
- **Operation Type:** Mutation

## Type Signature

`CollectionAddProductsPayload`

## Arguments

* `id`

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

  指定需要更新的分类的 ID。注意：不允许更新智能分类

* `productIds`

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

  计划添加到分类中的产品的 ID，如果产品已存在于分类中，则会触发错误，并且不会添加任何产品

## Returns

* `collection`

  [Collection](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/products-and-collections/objects/collection.md)

  更新的分类。如果引发错误，则返回null。

* `userErrors`

  [[UserError]!](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common-objects/objects/user-error.md)

  执行突变时发生的错误列表。

## Code Example

```graphql
mutation collectionAddProducts($id: ID! $productIds: [ID!] ) {
	collectionAddProducts(id: $id, productIds: $productIds ) 
		 {
			# CollectionAddProductsPayload fields
		}
		
	}

```

## Variables

```json
{
  "id": {},
  "productIds": {}
}
```

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