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

訊息，內含項目發布期間遇到的警告詳細資料。

JSON 表示法 
{
  "warnings": [
    {
      object (Warning)
    }
  ]
}
欄位
warnings[]

object (Warning)

要求期間發生的所有警告。

警告

代表要求期間遇到的單一警告。

JSON 表示法 
{
  "reason": string,
  "description": string
}
欄位
reason

string

警告原因。這是常數值，用於識別警告的近因。
description

string

警告說明。開發人員應根據這則訊息瞭解警告，並採取適當行動來解決問題。