Package google.ads.dai.v1

Индекс

• PartnerDiscoveryService (интерфейс)
• CreateCreativeOperationMetadata (сообщение)
• CreateCreativeRequest (сообщение)
• Creative (сообщение)
• DeleteCreativeRequest (сообщение)
• DynamicCreativeInfo (сообщение)
• FailureReason (сообщение)
• FailureReason.Reason (перечисление)
• GetCreativeRequest (сообщение)
• IngestionStatus (сообщение)
• IngestionStatus.State (перечисление)
• MediaFile (сообщение)
• MediaFile.Delivery (перечисление)

ПартнерДискавериСервис

Управляет приемом DAI и загрузкой креативов на YouTube.

СоздатьКреатив
rpc CreateCreative( CreateCreativeRequest ) returns ( Operation ) Создает креатив. Возвращает креатив в поле response в случае успешного завершения или google.rpc.Code в случае неудачи. Возвращает CreateCreativeOperationMetadata, включая статус приема в поле metadata .

УдалитьКреатив
rpc DeleteCreative( DeleteCreativeRequest ) returns ( Empty ) Удаляет объявление.

GetCreative
rpc GetCreative( GetCreativeRequest ) returns ( Creative ) Получает объявление.

Создатькреативоператионметаданные

Метаданные для длительной операции, возвращаемые CreateCreative. Представлено в виде metadata .

Поля
creative_url	string URL-адрес креатива, который использовался для загрузки. Это выбранный мезонинный URL-адрес или URL-адрес воспроизведения мультимедиа, выбранный на основе свойств, указанных в запросе.
gv_registry_id	string Уникальный идентификатор видеокреатива в случае успешной загрузки. Имя креативного ресурса — Creatives/ gv_registry_id .
create_time	Timestamp Время создания запроса на прием.
youtube_status	IngestionStatus Текущий статус загрузки YouTube.

СоздатьКреативныйЗапрос

Запрос PartnerDiscoveryService.CreateCreative .

Поля
creative	Creative Объявление, которое будет загружено.
dynamic_creative_info	DynamicCreativeInfo Информация о динамическом креативе. Требуется, если добавляемый креатив является динамическим.

Креатив

Креативный ресурс. Представляется в качестве response после завершения PartnerDiscoveryService.CreateCreative .

Поля
name	string Только вывод. Уникальное имя (идентификатор Google Video) креативного ресурса в формате креативы/ id .
advertiser	string Имя рекламодателя, указанное в этом креативе.
ad_system	string Необходимый. Название рекламной системы, генерирующей запрос на получение.
ad_title	string Название объявления.
ad_description	string Описание объявления.
mezzanines[]	MediaFile URL-адреса дополнительных файлов объявления и их свойства. Требуется хотя бы один из мезаннин или media_files.
media_files[]	MediaFile URL-адреса медиафайлов объявления и их свойства. Требуется хотя бы один из мезаннин или media_files.
network_code	string Необязательный. Сетевой код Google Ad Manager издателя, для которого предназначен креатив. Требуется, если объявление является динамическим и имеет DynamicCreativeInfo, указанное в CreateCreativeRequest.

Удалитькреативрекуест

Запрос PartnerDiscoveryService.DeleteCreative .

Поля
name	string Идентификатор видео Google, который нужно удалить.

ДинамическаяКреативИнфо

Информация, необходимая динамическому объявлению для выполнения обработки VCL.

Поля
dynamic_group_id	string Идентификатор, представляющий основную видеорекламу креатива. Все динамические объявления с одним и тем же идентификатором динамической группы могут считаться имеющими одинаковое содержание, но с разными динамическими аспектами объявления.
active_duration	Duration Продолжительность, в течение которой этот креатив считается активным и используется. По истечении этого времени креатив будет удален из хранилища видеокреативов. Продолжительность будет ограничена 180 днями. Если это поле не указано, будет применено время по умолчанию, равное 30 дням.

Причина сбоя

Причина сбоя при загрузке объявления.

Поля
reason	Reason Описание сбоя при загрузке объявления.
code	int32 Код состояния HTTP сбоя, если причина — DOWNLOAD_ERROR.

Причина

Возможные причины сбоя при загрузке объявления.

Перечисления
REASON_UNSPECIFIED	Значение по умолчанию.
DOWNLOAD_ERROR	Загрузка HTTP не удалась.
INTERNAL_ERROR	Внутренняя ошибка.
INVALID_MEDIA	Неверный носитель.

GetCreativeRequest

Запрос PartnerDiscoveryService.GetCreative .

Поля
name	string Креативный идентификатор видео Google.

Статус приема

Статус приема запроса на создание объявления.

Поля
state	State Текущее состояние загрузки видеообъявления.
failure_reason	FailureReason Причина, по которой креатив не удалось загрузить, если не удалось загрузить.
update_time	Timestamp Время последнего обновления задания приема.

Состояние

Состояние приема.

Перечисления
STATE_UNSPECIFIED	Значение по умолчанию.
PROCESSING	Видеообъявление все еще обрабатывается.
SUCCESS	Обработка видеообъявления успешно завершена.
FAILURE	Не удалось загрузить видеообъявление. См. раздел «Причина сбоя».

Медиафайл

Свойства, относящиеся к данному медиафайлу.

Поля
uri	string Необходимый. Уникальный URL-адрес медиафайла объявления.
delivery	Delivery Необходимый. Тип показа объявления.
height	int32 Исходная высота видеофайла в пикселях.
width	int32 Собственная ширина видеофайла в пикселях.
mime_type	string Необходимый. Тип MIME для файлового контейнера. Популярные типы MIME включают «video/x-flv» для Flash Video и «video/mp4» для MP4.
min_bitrate	int32 Минимальный битрейт медиафайла. Для видео с прогрессивной загрузкой это значение должно быть средним битрейтом.
max_bitrate	int32 Максимальный битрейт медиафайла. Для видео с прогрессивной загрузкой это значение должно быть средним битрейтом.

Доставка

Виды доставки.

Перечисления
DELIVERY_UNSPECIFIED	Стоимость доставки по умолчанию.
DELIVERY_PROGRESSIVE	Прогрессивная доставка видео.
DELIVERY_STREAMING	Потоковая доставка видео.