---
title: "publicationUpdate"
description: "修改和更新指定的Publication对象。"
doc_type: graphql
doc_category: adminGraphQL
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/apps/mutations/publication-update'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/apps/mutations/publication-update.md'
---
# publicationUpdate

修改和更新指定的Publication对象。

- **Required Scopes:** `write_publications`
- **API Version:** v20270301
- **API Type:** Admin
- **API Protocol:** GraphQL
- **Operation Type:** Mutation

## Type Signature

`PublicationUpdatePayload`

## Required Permissions

* `write_publications`

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

## Arguments

* `input`

  [PublicationUpdateInput!](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/apps/inputs/publication-update-input.md)

  用于更新Publication的输入字段。

* `id`

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

  需要更新的Publication的ID。

## Returns

* `publication`

  [Publication](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/apps/objects/publication.md)

  更新后的 Publication。

* `userErrors`

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

  执行过程中发生的错误列表。

## Code Example

```graphql
mutation publicationUpdate($input: PublicationUpdateInput! $id: ID! ) {
	publicationUpdate(input: $input, id: $id ) 
		 {
			# PublicationUpdatePayload fields
		}
		
	}

```

## Variables

```json
{
  "id": {},
  "input": {
    "publishablesToAdd": {},
    "publishablesToRemove": ""
  }
}
```

## Examples

### 更新Publication

更新Publication。

**Request:**

```json
mutation PublicationUpdate {
    publicationUpdate(
        id: "gid://shopline/Publication/57843853"
        input: {
            publishablesToRemove: ["gid://shopline/Product/16055271775622479314742093"]
            publishablesToAdd: ["gid://shopline/Product/16055271775622479314742093"]
        }
    ) {
        userErrors {
            code
            field
            message
        }
    }
}
```

**Response:**

```json
{
  "data": {
    "data": {
      "publicationUpdate": {
        "userErrors": []
      }
    }
  }
}
```

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