Method: publishers.items.publish

Kirimkan item untuk dipublikasikan di Play Store.

Item akan dikirim untuk ditinjau kecuali jika skipReview disetel ke benar (true), atau item dirilis bertahap dari pengiriman sebelumnya dengan publishType disetel ke STAGED_PUBLISH.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

Wajib. Nama item dalam bentuk publishers/{publisherId}/items/{itemId}

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{
  "publishType": enum (PublishType),
  "deployInfos": [
    {
      object (DeployInfo)
    }
  ],
  "skipReview": boolean,
  "blockOnWarnings": boolean
}
Kolom
publishType

enum (PublishType)

Opsional. Gunakan ini untuk mengontrol apakah item dipublikasikan segera setelah disetujui atau disiapkan untuk dipublikasikan di masa mendatang. Nilai defaultnya adalah DEFAULT_PUBLISH jika tidak ditetapkan.

deployInfos[]

object (DeployInfo)

Opsional. Informasi deployment tambahan, termasuk peluncuran persentase awal yang diinginkan. Secara default, nilai saat ini yang disimpan di dasbor developer akan digunakan jika tidak disetel.

skipReview

boolean

Opsional. Apakah akan mencoba melewati peninjauan item. API akan memvalidasi apakah item memenuhi syarat dan menampilkan error validasi jika item memerlukan peninjauan. Nilai defaultnya adalah false jika tidak ditetapkan.

blockOnWarnings

boolean

Opsional. Jika disetel ke benar (true), permintaan akan gagal jika ada peringatan selama validasi dan detailnya akan disertakan dalam error.details. Jika tidak, peringatan akan dianggap tidak memblokir dan akan diabaikan untuk validasi, tetapi akan disertakan dalam respons untuk diperiksa. Nilai defaultnya adalah false jika tidak ditetapkan.

Isi respons

Pesan respons untuk items.publish.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "name": string,
  "itemId": string,
  "state": enum (ItemState),
  "warningInfo": {
    object (WarningsInfo)
  }
}
Kolom
name

string

Nama item yang dikirimkan

itemId

string

Hanya output. ID item.

state

enum (ItemState)

Hanya output. Status pengiriman saat ini.

warningInfo

object (WarningsInfo)

Hanya output. Peringatan non-pemblokiran yang terjadi selama permintaan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

PublishType

Jenis publikasi item ini akan mengikuti jika lulus peninjauan.

Enum
PUBLISH_TYPE_UNSPECIFIED Nilai default. Ini sama dengan DEFAULT_PUBLISH.
DEFAULT_PUBLISH Kiriman akan dipublikasikan segera setelah disetujui.
STAGED_PUBLISH Setelah disetujui, kiriman akan dipentaskan dan kemudian dapat dipublikasikan oleh developer.

DeployInfo

Informasi deployment untuk saluran rilis tertentu. Digunakan dalam permintaan untuk memperbarui parameter deployment.

Representasi JSON
{
  "deployPercentage": integer
}
Kolom
deployPercentage

integer

Wajib. Persentase penerapan saat ini untuk saluran rilis (angka non-negatif antara 0 dan 100).

WarningsInfo

Pesan yang berisi detail peringatan yang terjadi selama items.publish.

Representasi JSON
{
  "warnings": [
    {
      object (Warning)
    }
  ]
}
Kolom
warnings[]

object (Warning)

Semua peringatan yang muncul selama permintaan.

Peringatan

Mewakili satu peringatan yang terjadi selama permintaan.

Representasi JSON
{
  "reason": string,
  "description": string
}
Kolom
reason

string

Alasan peringatan. Ini adalah nilai konstanta yang mengidentifikasi penyebab langsung peringatan.

description

string

Deskripsi peringatan. Developer harus menggunakan pesan ini untuk memahami peringatan dan mengambil tindakan yang sesuai untuk menyelesaikan masalah.