REST Resource: availabilityOrders.availabilityLines

Ресурс: AvailabilityLine

Строка доступности представляет собой набор настроек, для которых покупатель запрашивает доступность запасов и ответ от продавца. Для рабочего процесса см. AvailabilityOrder .

JSON-представление 
{
  "name": string,
  "product": string,
  "startTime": string,
  "endTime": string,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "budget": {
    object (Money)
  },
  "targeting": {
    object (Targeting)
  },
  "availabilityLineTerms": {
    object (LineTerms)
  },
  "state": enum (State),
  "rejection": {
    object (Rejection)
  },
  "createTime": string,
  "updateTime": string
}
Поля
name

string

Только вывод. Имя ресурса строки доступности в формате: availabilityOrders/123/availabilityLines/321 .

product

string

Только вывод. Название Product для которого предназначен этот запрос доступности. Формат = продукты/456

startTime
(deprecated)

string ( Timestamp format)

Только вывод. Время начала запроса доступности (включительно).

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

endTime
(deprecated)

string ( Timestamp format)

Только вывод. Время окончания запроса доступности (эксклюзивное).

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

startDate

object ( Date )

Только вывод. Дата начала запроса доступности (включительно). Тот же часовой пояс, что и у рекламного блока.

endDate

object ( Date )

Только вывод. Конечная дата запроса доступности (включительно). Тот же часовой пояс, что и у рекламного блока.

budget

object ( Money )

Только вывод. Бюджет наличия линии.

targeting

object ( Targeting )

Только вывод. Таргетинг, для которого запрашивается доступность.

availabilityLineTerms

object ( LineTerms )

Только вывод. Продавец может использовать [Complete][google.ads.xbid.outofhome.v1beta1.OrderManagementService.CompleteAvailabilityLine] для обновления [LineTerms].

state

enum ( State )

Только вывод. Состояние этого заказа доступности. См. жизненный цикл AvailabilityLine.State для AvailabilityLine.

Продавец может использовать специальные методы [Complete][google.ads.xbid.outofhome.v1beta1.OrderManagementService.CompleteAvailabilityLine] или [Reject][google.ads.xbid.outofhome.v1beta1.OrderManagementService.RejectAvailabilityLine], чтобы установить одно из следующих значений:

  • STATE_COMPLETED
  • STATE_REJECTED

соответственно.

rejection

object ( Rejection )

Сведения об отклонении для строки доступности.

createTime

string ( Timestamp format)

Только вывод. Временная метка создания строки доступности.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

updateTime

string ( Timestamp format)

Только вывод. Последнее обновление отметки времени для строки доступности.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

Состояние

Возможные значения состояния линии доступности.

Перечисления
STATE_UNSPECIFIED Значение по умолчанию, когда состояние линии доступности не указано или неизвестно в этой версии.
STATE_PENDING Ожидание доступности, когда покупатель предоставил настройки запроса доступности.
STATE_COMPLETED Состояние завершено, когда продавец предоставил ответ о доступности.
STATE_REJECTED Состояние отклонения, когда строка доступности отклонена продавцом. Необходимо предоставить подробную информацию об отклонении.
STATE_CANCELLED Состояние «Отменено», когда покупатель отменяет заказ до того, как продавец завершит или отклоняет ответ о доступности.

Методы

complete

 Отмечает существующую строку доступности как завершенную.

get

 Извлекает отдельную строку для заказа доступности.

list

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

reject

 Отмечает существующую строку доступности как отклоненную.