Method: publishers.items.publish

提交要在商店中发布的商品。

除非 skipReview 设置为 true，否则系统会提交商品以供审核；如果商品是根据之前提交的商品分阶段发布的，且 publishType 设置为 STAGED_PUBLISH，则系统也会提交商品以供审核。

HTTP 请求

POST https://chromewebstore.googleapis.com/v2/{name=publishers/*/items/*}:publish

网址采用 gRPC 转码语法。

路径参数

参数
name

string

必需。商品的名称，格式为 publishers/{publisherId}/items/{itemId}

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "publishType": enum (PublishType),
  "deployInfos": [
    {
      object (DeployInfo)
    }
  ],
  "skipReview": boolean,
  "blockOnWarnings": boolean
}
字段
publishType

enum (PublishType)

可选。使用此属性可控制商品在获得批准后是立即发布，还是在未来分阶段发布。如果未设置，则默认为 DEFAULT_PUBLISH。
deployInfos[]

object (DeployInfo)

可选。其他部署信息，包括所需的初始推出百分比。如果未设置，则默认为开发者信息中心内保存的当前值。
skipReview

boolean

可选。是否尝试跳过商品评价。API 将验证商品是否符合条件，如果商品需要审核，则返回验证错误。如果未设置，则默认为 false。
blockOnWarnings

boolean

可选。如果设置为 true，则在验证期间出现任何警告时，请求都会失败，并且详细信息会包含在 error.details 中。否则，警告将被视为非阻塞，在验证时会被忽略，但会包含在响应中以供检查。如果未设置，则默认为 false。

响应正文

items.publish 的响应消息。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "name": string,
  "itemId": string,
  "state": enum (ItemState),
  "warningInfo": {
    object (WarningsInfo)
  }
}
字段
name

string

提交的商品的名称
itemId

string

仅限输出。商品的 ID。
state

enum (ItemState)

仅限输出。提交内容的当前状态。
warningInfo

object (WarningsInfo)

仅限输出。请求期间遇到的非阻塞警告。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/chromewebstore

PublishType

相应商品通过审核后将采用的发布类型。

枚举
PUBLISH_TYPE_UNSPECIFIED 默认值。这与 DEFAULT_PUBLISH 相同。
DEFAULT_PUBLISH 提交内容在获得批准后会立即发布。
STAGED_PUBLISH 提交内容获得批准后，系统会将其暂存，然后开发者可以发布该内容。

DeployInfo

特定发布渠道的部署信息。用于更新部署参数的请求中。

JSON 表示法 
{
  "deployPercentage": integer
}
字段
deployPercentage

integer

必需。发布渠道的当前部署百分比（介于 0 到 100 之间的非负数）。

WarningsInfo

包含在 items.publish 期间遇到的警告的详细信息的消息。

JSON 表示法 
{
  "warnings": [
    {
      object (Warning)
    }
  ]
}
字段
warnings[]

object (Warning)

请求期间遇到的所有警告。

警告

表示在请求期间遇到的单个警告。

JSON 表示法 
{
  "reason": string,
  "description": string
}
字段
reason

string

警告的原因。这是一个常量值，用于标识警告的近因。
description

string

警告的说明。开发者应使用此消息来了解警告，并采取适当措施来解决问题。