Method: publishers.items.publish

Envie o item para publicação na loja.

O item será enviado para revisão, a menos que skipReview esteja definido como "true" ou que o item seja preparado de um envio anterior com publishType definido como STAGED_PUBLISH.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. Nome do item no formato publishers/{publisherId}/items/{itemId}

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "publishType": enum (PublishType),
  "deployInfos": [
    {
      object (DeployInfo)
    }
  ],
  "skipReview": boolean,
  "blockOnWarnings": boolean
}
Campos
publishType

enum (PublishType)

Opcional. Use isso para controlar se o item é publicado imediatamente após a aprovação ou preparado para publicação no futuro. O padrão é DEFAULT_PUBLISH se não estiver definido.

deployInfos[]

object (DeployInfo)

Opcional. Outras informações de implantação, incluindo a porcentagem inicial desejada de lançamento. O padrão é o valor atual salvo no painel de controle do desenvolvedor, se não estiver definido.

skipReview

boolean

Opcional. Se uma tentativa de pular a análise do item será feita. A API vai validar se o item se qualifica e retornar um erro de validação se ele precisar de revisão. O padrão é false se não estiver definido.

blockOnWarnings

boolean

Opcional. Quando definido como "true", a solicitação falhará se houver avisos durante a validação, e os detalhes serão incluídos no error.details. Caso contrário, os avisos serão tratados como não bloqueadores e serão ignorados para validação, mas incluídos na resposta para inspeção. O padrão é false se não estiver definido.

Corpo da resposta

Mensagem de resposta para items.publish.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "name": string,
  "itemId": string,
  "state": enum (ItemState),
  "warningInfo": {
    object (WarningsInfo)
  }
}
Campos
name

string

O nome do item enviado

itemId

string

Apenas saída. ID do item.

state

enum (ItemState)

Apenas saída. O estado atual do envio.

warningInfo

object (WarningsInfo)

Apenas saída. Avisos sem bloqueio encontrados durante a solicitação.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

PublishType

O tipo de publicação que este item seguirá se passar pela revisão.

Tipos enumerados
PUBLISH_TYPE_UNSPECIFIED Valor padrão. É o mesmo que DEFAULT_PUBLISH.
DEFAULT_PUBLISH O envio será publicado imediatamente após a aprovação.
STAGED_PUBLISH Depois da aprovação, o envio será preparado e poderá ser publicado pelo desenvolvedor.

DeployInfo

Informações de implantação para um canal de lançamento específico. Usado em solicitações para atualizar parâmetros de implantação.

Representação JSON
{
  "deployPercentage": integer
}
Campos
deployPercentage

integer

Obrigatório. A porcentagem de implantação atual do canal de lançamento (número não negativo entre 0 e 100).

WarningsInfo

Mensagem com detalhes sobre os avisos encontrados durante "items.publish".

Representação JSON
{
  "warnings": [
    {
      object (Warning)
    }
  ]
}
Campos
warnings[]

object (Warning)

Todos os avisos encontrados durante a solicitação.

Aviso

Representa um único aviso encontrado durante a solicitação.

Representação JSON
{
  "reason": string,
  "description": string
}
Campos
reason

string

O motivo do aviso. Esse é um valor constante que identifica a causa próxima do aviso.

description

string

Uma descrição do aviso. Os desenvolvedores precisam usar essa mensagem para entender o aviso e tomar as medidas adequadas para resolver o problema.