Method: publishers.items.publish

Reichen Sie den Artikel zur Veröffentlichung im Store ein.

Das Element wird zur Überprüfung eingereicht, es sei denn, skipReview ist auf „true“ gesetzt oder das Element wird aus einer vorherigen Einreichung mit publishType auf STAGED_PUBLISH gesetzt bereitgestellt.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Der Name des Artikels im Format publishers/{publisherId}/items/{itemId}

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "publishType": enum (PublishType),
  "deployInfos": [
    {
      object (DeployInfo)
    }
  ],
  "skipReview": boolean,
  "blockOnWarnings": boolean
}
Felder
publishType

enum (PublishType)

Optional. Damit können Sie festlegen, ob das Element nach der Genehmigung sofort veröffentlicht oder für die Veröffentlichung in der Zukunft geplant wird. Wenn kein Wert festgelegt ist, wird standardmäßig DEFAULT_PUBLISH verwendet.

deployInfos[]

object (DeployInfo)

Optional. Zusätzliche Informationen zur Bereitstellung, einschließlich des gewünschten anfänglichen prozentualen Rollouts. Wenn nicht festgelegt, wird standardmäßig der aktuelle Wert verwendet, der im Entwickler-Dashboard gespeichert ist.

skipReview

boolean

Optional. Gibt an, ob die Artikelüberprüfung übersprungen werden soll. Die API prüft, ob der Artikel die Voraussetzungen erfüllt, und gibt einen Validierungsfehler zurück, wenn der Artikel überprüft werden muss. Wenn kein Wert festgelegt ist, wird standardmäßig false verwendet.

blockOnWarnings

boolean

Optional. Wenn der Wert auf „true“ gesetzt ist, schlägt die Anfrage fehl, wenn bei der Validierung Warnungen auftreten. Die Details werden in error.details angegeben. Andernfalls werden Warnungen als nicht blockierend behandelt und bei der Validierung ignoriert, sind aber in der Antwort enthalten. Wenn kein Wert festgelegt ist, wird standardmäßig false verwendet.

Antworttext

Antwortnachricht für items.publish.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "name": string,
  "itemId": string,
  "state": enum (ItemState),
  "warningInfo": {
    object (WarningsInfo)
  }
}
Felder
name

string

Der Name des eingereichten Artikels

itemId

string

Nur Ausgabe. Die ID des Artikels.

state

enum (ItemState)

Nur Ausgabe. Der aktuelle Status des Antrags.

warningInfo

object (WarningsInfo)

Nur Ausgabe. Nicht blockierende Warnungen, die während der Anfrage aufgetreten sind.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

PublishType

Die Art der Veröffentlichung dieses Artikels, wenn er die Überprüfung besteht.

Enums
PUBLISH_TYPE_UNSPECIFIED Standardwert. Dies entspricht DEFAULT_PUBLISH.
DEFAULT_PUBLISH Die Einreichung wird sofort nach der Genehmigung veröffentlicht.
STAGED_PUBLISH Nach der Genehmigung wird die Einreichung bereitgestellt und kann dann vom Entwickler veröffentlicht werden.

DeployInfo

Bereitstellungsinformationen für einen bestimmten Release-Channel. Wird in Anfragen zum Aktualisieren von Bereitstellungsparametern verwendet.

JSON-Darstellung
{
  "deployPercentage": integer
}
Felder
deployPercentage

integer

Erforderlich. Der aktuelle Bereitstellungsprozentsatz für den Release-Channel (nicht negative Zahl zwischen 0 und 100).

WarningsInfo

Nachricht mit Details zu Warnungen, die während „items.publish“ aufgetreten sind.

JSON-Darstellung
{
  "warnings": [
    {
      object (Warning)
    }
  ]
}
Felder
warnings[]

object (Warning)

Alle Warnungen, die während der Anfrage aufgetreten sind.

Warnung

Stellt eine einzelne Warnung dar, die während der Anfrage aufgetreten ist.

JSON-Darstellung
{
  "reason": string,
  "description": string
}
Felder
reason

string

Der Grund für die Warnung. Dies ist ein konstanter Wert, der die unmittelbare Ursache der Warnung angibt.

description

string

Eine Beschreibung der Warnung. Entwickler sollten diese Nachricht nutzen, um die Warnung zu verstehen und geeignete Maßnahmen zu ergreifen, um das Problem zu beheben.