Method: publishers.items.publish

ストアで公開するアイテムを送信します。

skipReview が true に設定されている場合、または publishTypeSTAGED_PUBLISH に設定された以前の送信からアイテムがステージングされている場合を除き、アイテムは審査のために送信されます。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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

警告の説明。デベロッパーはこのメッセージを使用して警告を理解し、問題を解決するための適切な措置を講じる必要があります。