Method: publishers.items.publish

Отправьте материал для публикации в магазине.

Материал будет отправлен на проверку, если skipReview не установлен в значение true, или если материал не подготовлен из предыдущей отправки с publishType , установленным в значение STAGED_PUBLISH .

HTTP-запрос

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

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
name

string

Обязательно. Название элемента в формате publishers/{publisherId}/items/{itemId}

Текст запроса

Тело запроса содержит данные следующей структуры:

JSON-представление 
{
  "publishType": enum (PublishType),
  "deployInfos": [
    {
      object (DeployInfo)
    }
  ],
  "skipReview": boolean,
  "blockOnWarnings": boolean
}
Поля
publishType

enum ( PublishType )

Необязательный параметр. Используйте его, чтобы определить, будет ли элемент опубликован немедленно после утверждения или подготовлен к публикации в будущем. По умолчанию используется значение DEFAULT_PUBLISH если параметр не задан.

deployInfos[]

object ( DeployInfo )

Необязательно. Дополнительная информация о развертывании, включая желаемый начальный процент развертывания. По умолчанию используется текущее значение, сохраненное в панели разработчика, если оно не задано.

skipReview

boolean

Необязательный параметр. Следует ли пытаться пропустить проверку товара. API проверит, соответствует ли товар требованиям, и вернет ошибку проверки, если проверка необходима. По умолчанию значение равно false если параметр не задан.

blockOnWarnings

boolean

Необязательный параметр. Если установлено значение true, запрос завершится ошибкой при наличии предупреждений во время проверки, и подробности будут включены в error.details . В противном случае предупреждения рассматриваются как неблокирующие и будут игнорироваться при проверке, но будут включены в ответ для проверки. По умолчанию значение false , если параметр не задан.

Ответный текст

Ответное сообщение для items.publish .

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "name": string,
  "itemId": string,
  "state": enum (ItemState),
  "warningInfo": {
    object (WarningsInfo)
  }
}
Поля
name

string

Название отправленного материала

itemId

string

Только вывод. Идентификатор товара.

state

enum ( ItemState )

Только вывод. Текущее состояние отправленной работы.

warningInfo

object ( WarningsInfo )

Только вывод. В ходе запроса обнаружены неблокирующие предупреждения.

Области полномочий

Требуется следующая область действия OAuth:

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

Тип публикации

Тип публикации, которой будет соответствовать данная статья, если она пройдет проверку.

Перечисления
PUBLISH_TYPE_UNSPECIFIED Значение по умолчанию. Это то же самое, что и DEFAULT_PUBLISH.
DEFAULT_PUBLISH После одобрения заявка будет опубликована немедленно.
STAGED_PUBLISH После одобрения заявка будет подготовлена ​​к публикации, после чего разработчик сможет её разместить.

DeployInfo

Информация о развертывании для конкретного канала выпуска. Используется в запросах на обновление параметров развертывания.

JSON-представление 
{
  "deployPercentage": integer
}
Поля
deployPercentage

integer

Обязательно. Текущий процент развертывания для канала выпуска (неотрицательное число от 0 до 100).

Информация о предупреждениях

Сообщение с подробной информацией о предупреждениях, обнаруженных во время публикации элементов (items.publish).

JSON-представление 
{
  "warnings": [
    {
      object (Warning)
    }
  ]
}
Поля
warnings[]

object ( Warning )

Все предупреждения, обнаруженные в ходе выполнения запроса.

Предупреждение

Представляет собой единичное предупреждение, обнаруженное во время выполнения запроса.

JSON-представление 
{
  "reason": string,
  "description": string
}
Поля
reason

string

Причина предупреждения. Это постоянная величина, указывающая на непосредственную причину предупреждения.

description

string

Описание предупреждения. Разработчикам следует использовать это сообщение, чтобы понять суть предупреждения и предпринять соответствующие действия для решения проблемы.