REST Resource: orders.lines.assignments

Ресурс: Задание

Назначение, привязывающее креативы к строкам.

JSON-представление 
{
  "name": string,
  "externalId": string,
  "creativeAsset": string,
  "state": enum (State),

  // Union field disapproval_type can be only one of the following:
  "disapproval": {
    object (Disapproval)
  },
  "adUnitDisapprovals": {
    object (AdUnitCreativeDisapprovals)
  }
  // End of list of possible types for union field disapproval_type.
}
Поля
name

string

Только вывод. Имя ресурса назначения креатива в формате: orders/{order_id}/lines/{line_id}/assignments/{id} .

externalId

string

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

creativeAsset

string

Только вывод. Креативный ресурс, который будет обслуживаться для линии. Формат = CreativeAssets/123

state

enum ( State )

Только вывод. Если STATE_DISAPPROVED, необходимо предоставить сведения об отклонении.

Поле объединения disapproval_type . Только вывод. Сведения об отклонении задания. Это может быть уровень строки или рекламного блока. Сведения об отклонении задания указаны на уровне задания или рекламного блока. Это позволяет предоставить подробную информацию об отклонении, которая применима только к подмножеству рекламных блоков, на которые нацелена эта строка. disapproval_type может быть только одним из следующих:
disapproval

object ( Disapproval )

Сведения об отклонении назначения, применимые ко всем рекламным блокам.

adUnitDisapprovals

object ( AdUnitCreativeDisapprovals )

Информация об отклонении для каждого рекламного блока.

Состояние

Возможные значения состояния назначения.

Перечисления
STATE_UNSPECIFIED Значение по умолчанию, когда состояние назначения не указано или неизвестно в этой версии.
STATE_PENDING_REVIEW Когда подробные сведения о креативе предоставлены покупателем и ожидается проверка продавцом.
STATE_APPROVED Когда креатив одобрен продавцом.
STATE_DISAPPROVED Когда объявление отклонено продавцом. Необходимо предоставить подробную информацию об отклонении.
STATE_REVOKED Когда креатив был отозван покупателем или системой.

AdUnitCreativeОтклонения

Причины отклонения рекламного блока.

JSON-представление 
{
  "disapprovals": {
    string: {
      object (Disapproval)
    },
    ...
  }
}
Поля
disapprovals

map (key: string, value: object ( Disapproval ))

Ключ — это имя рекламного блока (например, adUnits/123), а значение — информация об отклонении.

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

Методы

approve

 Утверждает существующее задание.

disapprove

 Отклоняет существующее задание.

get

 Получает индивидуальное назначение для строки.

list

 Перечисляет назначения для линии.

patch

 Обновляет существующее задание.