Method: publishers.items.publish

Envoyez l'article à publier dans le magasin.

L'élément sera envoyé pour examen, sauf si skipReview est défini sur "true" ou si l'élément est mis en scène à partir d'un envoi précédent avec publishType défini sur STAGED_PUBLISH.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Nom de l'élément au format publishers/{publisherId}/items/{itemId}

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "publishType": enum (PublishType),
  "deployInfos": [
    {
      object (DeployInfo)
    }
  ],
  "skipReview": boolean,
  "blockOnWarnings": boolean
}
Champs
publishType

enum (PublishType)

Facultatif. Utilisez cette option pour déterminer si l'élément est publié immédiatement après approbation ou mis en attente pour publication ultérieure. La valeur par défaut est DEFAULT_PUBLISH si elle n'est pas définie.
deployInfos[]

object (DeployInfo)

Facultatif. Informations de déploiement supplémentaires, y compris le pourcentage de déploiement initial souhaité. Si elle n'est pas défini, la valeur par défaut est celle actuellement enregistrée dans le tableau de bord des développeurs.
skipReview

boolean

Facultatif. Indique s'il faut essayer d'ignorer l'examen de l'élément. L'API vérifie si l'article est éligible et renvoie une erreur de validation s'il doit être examiné. La valeur par défaut est false si elle n'est pas définie.
blockOnWarnings

boolean

Facultatif. Si la valeur est définie sur "true", la requête échouera en cas d'avertissement lors de la validation. Les détails seront inclus dans error.details. Sinon, les avertissements sont traités comme non bloquants et seront ignorés pour la validation, mais seront inclus dans la réponse pour inspection. La valeur par défaut est false si elle n'est pas définie.

Corps de la réponse

Message de réponse pour items.publish.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "name": string,
  "itemId": string,
  "state": enum (ItemState),
  "warningInfo": {
    object (WarningsInfo)
  }
}
Champs
name

string

Nom de l'élément envoyé
itemId

string

Uniquement en sortie. Identifiant de l'article.
state

enum (ItemState)

Uniquement en sortie. État actuel de l'envoi.
warningInfo

object (WarningsInfo)

Uniquement en sortie. Avertissements non bloquants rencontrés lors de la requête.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

PublishType

Le type de publication de cet élément sera appliqué s'il est approuvé.

Enums
PUBLISH_TYPE_UNSPECIFIED Valeur par défaut. Cette valeur est identique à DEFAULT_PUBLISH.
DEFAULT_PUBLISH Une fois approuvée, la contribution sera publiée immédiatement.
STAGED_PUBLISH Une fois approuvée, la mise à jour envoyée sera mise en scène et pourra ensuite être publiée par le développeur.

DeployInfo

Informations sur le déploiement pour un canal de publication spécifique. Utilisé dans les requêtes de mise à jour des paramètres de déploiement.

Représentation JSON 
{
  "deployPercentage": integer
}
Champs
deployPercentage

integer

Obligatoire. Pourcentage de déploiement actuel pour le canal de publication (nombre non négatif compris entre 0 et 100).

WarningsInfo

Message contenant des informations sur les avertissements rencontrés lors de l'opération items.publish.

Représentation JSON 
{
  "warnings": [
    {
      object (Warning)
    }
  ]
}
Champs
warnings[]

object (Warning)

Tous les avertissements rencontrés lors de la requête.

Avertissement

Représente un seul avertissement rencontré lors de la requête.

Représentation JSON 
{
  "reason": string,
  "description": string
}
Champs
reason

string

Raison de l'avertissement. Il s'agit d'une valeur constante qui identifie la cause immédiate de l'avertissement.
description

string

Description de l'avertissement. Les développeurs doivent utiliser ce message pour comprendre l'avertissement et prendre les mesures appropriées pour résoudre le problème.