Method: adPlays.createWithExternalIds

Создает рекламную игру с внешними идентификаторами.

  • В случае успеха возвращает вновь созданный рекламный ролик.
  • Возвращает код ошибки INVALID_ARGUMENT если указаны неверный внешний идентификатор рекламного блока, внешний идентификатор заказа, внешний идентификатор строки или внешний идентификатор креативного ресурса.
  • Возвращает код ошибки INVALID_ARGUMENT если уже существует воспроизведение рекламы для того же рекламного блока, заказа, строки и креатива с тем же временем начала.
  • Возвращает код ошибки NOT_FOUND если не найден соответствующий внешний идентификатор рекламного блока, внешний идентификатор заказа, внешний идентификатор строки или внешний идентификатор креативного ресурса.

HTTP-запрос

POST https://dv360outofhomeseller.googleapis.com/v1beta1/adPlays:createWithExternalIds

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

Тело запроса

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

JSON-представление 
{
  "lineExternalId": string,
  "orderExternalId": string,
  "adUnitExternalId": string,
  "creativeAssetExternalId": string,
  "startTime": string,
  "endTime": string,
  "recordTime": string,
  "impressions": number
}
Поля
lineExternalId

string

Необходимый. Внешний идентификатор линии, к которой принадлежит воспроизведение рекламы. Формат: 123 .

orderExternalId

string

Необходимый. Внешний идентификатор заказа, которому принадлежит воспроизведение этой рекламы. Формат: 456 .

adUnitExternalId

string

Необходимый. Внешний идентификатор рекламного блока, на котором было показано это объявление. Формат: 789 .

creativeAssetExternalId

string

Необходимый. Внешний идентификатор объявления, которое было показано при воспроизведении объявления. Формат: 3210 .

startTime

string ( Timestamp format)

Необходимый. Время начала воспроизведения рекламы (включительно). Должно быть в прошлом и в течение последних 3 дней.

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

endTime

string ( Timestamp format)

Необходимый. Время окончания показа рекламы (эксклюзивное). Должно быть в прошлом и после времени начала.

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

recordTime

string ( Timestamp format)

Необязательный. Время, когда был записан этот рекламный ролик. Должно быть в прошлом и после окончания времени.

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

impressions

number

Необходимый. Общее количество показов.

Тело ответа

В случае успеха тело ответа содержит экземпляр AdPlay .

Области авторизации

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

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

Дополнительную информацию см. в обзоре OAuth 2.0 .