Method: publishers.items.publish

Envía el elemento para que se publique en la tienda.

El elemento se enviará para su revisión, a menos que skipReview se establezca en verdadero o que el elemento se prepare a partir de un envío anterior con publishType establecido en STAGED_PUBLISH.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
name

string

Obligatorio. Nombre del elemento en el formato publishers/{publisherId}/items/{itemId}

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON
{
  "publishType": enum (PublishType),
  "deployInfos": [
    {
      object (DeployInfo)
    }
  ],
  "skipReview": boolean,
  "blockOnWarnings": boolean
}
Campos
publishType

enum (PublishType)

Es opcional. Úsalo para controlar si el elemento se publica de inmediato cuando se aprueba o se prepara para su publicación en el futuro. El valor predeterminado es DEFAULT_PUBLISH si no se establece.

deployInfos[]

object (DeployInfo)

Es opcional. Información de implementación adicional, incluido el porcentaje de lanzamiento inicial deseado. El valor predeterminado es el valor actual guardado en el panel para desarrolladores si no se establece.

skipReview

boolean

Es opcional. Indica si se debe intentar omitir la revisión del elemento. La API validará si el elemento cumple con los requisitos y mostrará un error de validación si el elemento requiere revisión. El valor predeterminado es false si no se establece.

blockOnWarnings

boolean

Es opcional. Cuando se establece en verdadero, la solicitud fallará si hay advertencias durante la validación y los detalles se incluirán en error.details. De lo contrario, las advertencias se tratan como no bloqueadoras y se ignorarán para la validación, pero se incluirán en la respuesta para su inspección. El valor predeterminado es false si no se establece.

Cuerpo de la respuesta

Mensaje de respuesta para items.publish.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON
{
  "name": string,
  "itemId": string,
  "state": enum (ItemState),
  "warningInfo": {
    object (WarningsInfo)
  }
}
Campos
name

string

Es el nombre del elemento que se envió.

itemId

string

Solo salida. Se trata del ID del artículo.

state

enum (ItemState)

Solo salida. Es el estado actual del envío.

warningInfo

object (WarningsInfo)

Solo salida. Son las advertencias no bloqueadoras que se encontraron durante la solicitud.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

PublishType

Es el tipo de publicación que seguirá este elemento si pasa la revisión.

Enums
PUBLISH_TYPE_UNSPECIFIED Valor predeterminado Es igual a DEFAULT_PUBLISH.
DEFAULT_PUBLISH El envío se publicará de inmediato después de su aprobación.
STAGED_PUBLISH Después de la aprobación, el envío se preparará y el desarrollador podrá publicarlo.

DeployInfo

Información de implementación para un canal de versiones específico. Se usa en las solicitudes para actualizar los parámetros de implementación.

Representación JSON
{
  "deployPercentage": integer
}
Campos
deployPercentage

integer

Obligatorio. Es el porcentaje de implementación actual para el canal de versiones (número no negativo entre 0 y 100).

WarningsInfo

Mensaje que contiene detalles sobre las advertencias que se encontraron durante items.publish.

Representación JSON
{
  "warnings": [
    {
      object (Warning)
    }
  ]
}
Campos
warnings[]

object (Warning)

Son todas las advertencias que se encontraron durante la solicitud.

Advertencia

Representa una sola advertencia que se encontró durante la solicitud.

Representación JSON
{
  "reason": string,
  "description": string
}
Campos
reason

string

Es el motivo de la advertencia. Este es un valor constante que identifica la causa próxima de la advertencia.

description

string

Es una descripción de la advertencia. Los desarrolladores deben usar este mensaje para comprender la advertencia y tomar las medidas adecuadas para resolver el problema.