Method: publishers.items.publish

Prześlij element do opublikowania w sklepie.

Element zostanie przesłany do sprawdzenia, chyba że parametr skipReview ma wartość true lub element jest przygotowywany do publikacji na podstawie poprzedniego przesłania z parametrem publishType ustawionym na STAGED_PUBLISH.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
name

string

Wymagane. Nazwa elementu w postaci publishers/{publisherId}/items/{itemId}

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

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

enum (PublishType)

Opcjonalnie. Użyj tego parametru, aby określić, czy element ma zostać opublikowany natychmiast po zatwierdzeniu, czy też przygotowany do opublikowania w przyszłości. Jeśli nie zostanie ustawiony, domyślna wartość to DEFAULT_PUBLISH.
deployInfos[]

object (DeployInfo)

Opcjonalnie. Dodatkowe informacje o wdrożeniu, w tym pożądany początkowy procent wdrożenia etapowego. Jeśli nie zostanie ustawiony, domyślna wartość to bieżąca wartość zapisana w Konsoli dewelopera.
skipReview

boolean

Opcjonalnie. Czy próbować pominąć sprawdzanie elementu. Interfejs API sprawdzi, czy element kwalifikuje się do pominięcia sprawdzania, i zwróci błąd weryfikacji, jeśli element wymaga sprawdzenia. Jeśli nie zostanie ustawiony, domyślna wartość to false.
blockOnWarnings

boolean

Opcjonalnie. Jeśli ta opcja jest ustawiona na true, żądanie zakończy się niepowodzeniem, jeśli podczas weryfikacji wystąpią ostrzeżenia, a szczegóły zostaną uwzględnione w error.details. W przeciwnym razie ostrzeżenia są traktowane jako nieblokujące i będą ignorowane podczas weryfikacji, ale zostaną uwzględnione w odpowiedzi do sprawdzenia. Jeśli nie zostanie ustawiony, domyślna wartość to false.

Treść odpowiedzi

Komunikat odpowiedzi dla items.publish.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

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

string

Nazwa przesłanego elementu
itemId

string

Tylko dane wyjściowe. Identyfikator elementu.
state

enum (ItemState)

Tylko dane wyjściowe. Bieżący stan przesłania.
warningInfo

object (WarningsInfo)

Tylko dane wyjściowe. Ostrzeżenia nieblokujące, które wystąpiły podczas żądania.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

PublishType

Typ publikacji, który będzie stosowany w przypadku zatwierdzenia elementu.

Wartości w polu enum
PUBLISH_TYPE_UNSPECIFIED Wartość domyślna. Jest to to samo co DEFAULT_PUBLISH.
DEFAULT_PUBLISH Przesłane treści zostaną opublikowane natychmiast po zatwierdzeniu.
STAGED_PUBLISH Po zatwierdzeniu przesłane treści zostaną przygotowane do publikacji, a deweloper będzie mógł je opublikować.

DeployInfo

Informacje o wdrożeniu w przypadku konkretnego kanału dystrybucji. Używane w żądaniach aktualizacji parametrów wdrożenia.

Zapis JSON 
{
  "deployPercentage": integer
}
Pola
deployPercentage

integer

Wymagane. Bieżący procent wdrożenia w przypadku kanału dystrybucji (liczba nieujemna z zakresu od 0 do 100).

WarningsInfo

Wiadomość zawierająca szczegółowe informacje o ostrzeżeniach, które wystąpiły podczas wykonywania metody items.publish.

Zapis JSON 
{
  "warnings": [
    {
      object (Warning)
    }
  ]
}
Pola
warnings[]

object (Warning)

Wszystkie ostrzeżenia, które wystąpiły podczas żądania.

Ostrzeżenie

Reprezentuje pojedyncze ostrzeżenie, które wystąpiło podczas żądania.

Zapis JSON 
{
  "reason": string,
  "description": string
}
Pola
reason

string

Powód ostrzeżenia. Jest to stała wartość, która identyfikuje bezpośrednią przyczynę ostrzeżenia.
description

string

Opis ostrzeżenia. Deweloperzy powinni używać tego komunikatu, aby zrozumieć ostrzeżenie i podjąć odpowiednie działania w celu rozwiązania problemu.