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
}
欄位
publishType

enum (PublishType)

(選用步驟) 您可以藉此控制項目是否要在核准後立即發布，或是暫存以留待日後發布。如果未設定，則預設值為 DEFAULT_PUBLISH。
deployInfos[]

object (DeployInfo)

(選用步驟) 其他部署資訊，包括期望的初始推出百分比。如未設定，則預設為開發人員資訊主頁中儲存的目前值。
skipReview

boolean

(選用步驟) 是否嘗試略過項目審查。API 會驗證商品是否符合資格，如果商品需要審查，則會傳回驗證錯誤。如果未設定，則預設值為 false。

回應主體

items.publish 的回應訊息。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "name": string,
  "itemId": string,
  "state": enum (ItemState)
}
欄位
name

string

提交的項目名稱
itemId

string

僅供輸出。商品的 ID。
state

enum (ItemState)

僅供輸出。提交內容的目前狀態。

授權範圍

需要下列 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 之間的非負數)。