Method: publishers.items.publish

Invia l'elemento da pubblicare nello store.

L'elemento verrà inviato per la revisione, a meno che skipReview non sia impostato su true o che l'elemento non sia stato messo in scena da un invio precedente con publishType impostato su STAGED_PUBLISH.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Nome dell'elemento nel formato publishers/{publisherId}/items/{itemId}

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

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

enum (PublishType)

Facoltativo. Utilizza questo parametro per controllare se l'elemento viene pubblicato immediatamente dopo l'approvazione o se viene messo in scena per la pubblicazione in futuro. Se non viene impostato, il valore predefinito è DEFAULT_PUBLISH.

deployInfos[]

object (DeployInfo)

Facoltativo. Informazioni di deployment aggiuntive, inclusa la percentuale di implementazione iniziale desiderata. Se non viene impostato, il valore predefinito è il valore corrente salvato nella dashboard dello sviluppatore.

skipReview

boolean

Facoltativo. Indica se tentare di saltare la revisione dell'elemento. L'API convaliderà se l'elemento è idoneo e restituirà un errore di convalida se l'elemento richiede una revisione. Se non viene impostato, il valore predefinito è false.

blockOnWarnings

boolean

Facoltativo. Se impostato su true, la richiesta non andrà a buon fine se durante la convalida vengono visualizzati avvisi e i dettagli verranno inclusi in error.details. In caso contrario, gli avvisi vengono trattati come non bloccanti e verranno ignorati per la convalida, ma verranno inclusi nella risposta per l'ispezione. Se non viene impostato, il valore predefinito è false.

Corpo della risposta

Messaggio di risposta per items.publish.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

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

string

Il nome dell'elemento inviato

itemId

string

Solo output. ID dell'articolo.

state

enum (ItemState)

Solo output. Lo stato attuale dell'invio.

warningInfo

object (WarningsInfo)

Solo output. Avvisi non bloccanti rilevati durante la richiesta.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

PublishType

Il tipo di pubblicazione che questo elemento seguirà se supera la revisione.

Enum
PUBLISH_TYPE_UNSPECIFIED Valore predefinito. Uguale a DEFAULT_PUBLISH.
DEFAULT_PUBLISH L'invio verrà pubblicato immediatamente dopo l'approvazione.
STAGED_PUBLISH Dopo l'approvazione, l'invio verrà messo in scena e potrà essere pubblicato dallo sviluppatore.

DeployInfo

Informazioni sul deployment per un canale di rilascio specifico. Utilizzato nelle richieste per aggiornare i parametri di deployment.

Rappresentazione JSON
{
  "deployPercentage": integer
}
Campi
deployPercentage

integer

Obbligatorio. La percentuale di deployment attuale per il canale di rilascio (numero non negativo compreso tra 0 e 100).

WarningsInfo

Messaggio contenente i dettagli degli avvisi rilevati durante items.publish.

Rappresentazione JSON
{
  "warnings": [
    {
      object (Warning)
    }
  ]
}
Campi
warnings[]

object (Warning)

Tutti gli avvisi rilevati durante la richiesta.

Warning

Rappresenta un singolo avviso rilevato durante la richiesta.

Rappresentazione JSON
{
  "reason": string,
  "description": string
}
Campi
reason

string

Il motivo dell'avviso. Si tratta di un valore costante che identifica la causa prossima dell'avviso.

description

string

Una descrizione dell'avviso. Gli sviluppatori devono utilizzare questo messaggio per comprendere l'avviso e intraprendere le azioni appropriate per risolvere il problema.