Method: sdfdownloadtasks.create

Создаёт задачу загрузки SDF. Возвращает Operation .

Задача загрузки SDF-файлов (SDF Download Task) — это длительная асинхронная операция. Тип metadata этой операции — SdfDownloadTaskMetadata . В случае успешного запроса тип response операции — SdfDownloadTask . Ответ не будет содержать загруженные файлы, которые необходимо получить с помощью media.download . Состояние операции можно получить с помощью sdfdownloadtask.operations.get .

Любые ошибки можно найти в error.message . Обратите внимание, что error.details должен быть пустым.

HTTP-запрос

POST https://displayvideo.googleapis.com/v3/sdfdownloadtasks

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

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

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

JSON-представление 
{
  "version": enum (SdfVersion),

  // Union field root_id can be only one of the following:
  "partnerId": string,
  "advertiserId": string
  // End of list of possible types for union field root_id.

  // Union field filtering_option can be only one of the following:
  "parentEntityFilter": {
    object (ParentEntityFilter)
  },
  "idFilter": {
    object (IdFilter)
  },
  "inventorySourceFilter": {
    object (InventorySourceFilter)
  }
  // End of list of possible types for union field filtering_option.
}
Поля
version

enum ( SdfVersion )

Обязательно. Версия SDF загруженного файла. Если задано значение SDF_VERSION_UNSPECIFIED , по умолчанию будет использоваться версия, указанная рекламодателем или партнёром, идентифицированным по root_id . Рекламодатель наследует свою версию SDF от партнёра, если не указано иное.

Поле объединения root_id . Обязательно. Корневой идентификатор определяет контекст запроса на загрузку. Необходимо задать только одно поле. root_id может быть только одним из следующих:
partnerId

string ( int64 format)

Идентификатор партнера, для которого необходимо загрузить SDF.

advertiserId

string ( int64 format)

Идентификатор рекламодателя, для которого необходимо загрузить SDF.

Поле объединения filtering_option . Обязательно. Параметры, определяющие типы и диапазоны сущностей для загрузки. Необходимо задать только одно поле. filtering_option может быть только одним из следующих:
parentEntityFilter

object ( ParentEntityFilter )

Фильтрация по выбранным типам файлов. Сущности в каждом файле фильтруются по выбранному набору сущностей фильтра. Сущности фильтра должны быть того же типа, что и выбранные типы файлов, или родительского типа по отношению к ним.

idFilter

object ( IdFilter )

Фильтрует сущности по их идентификаторам.

inventorySourceFilter

object ( InventorySourceFilter )

Фильтрация источников инвентаря по их идентификаторам.

Тело ответа

В случае успеха тело ответа содержит вновь созданный экземпляр Operation .

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

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

  • https://www.googleapis.com/auth/display-video

Для получения более подробной информации см.OAuth 2.0 Overview .

ParentEntityFilter

Параметр фильтрации, который фильтрует выбранные типы файлов, принадлежащие выбранному набору объектов фильтра.

JSON-представление 
{
  "fileType": [
    enum (FileType)
  ],
  "filterType": enum (FilterType),
  "filterIds": [
    string
  ]
}
Поля
fileType[]

enum ( FileType )

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

filterType

enum ( FilterType )

Обязательно. Тип фильтра, используемый для фильтрации выбранных сущностей.

filterIds[]

string ( int64 format)

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

Тип файла

Возможные типы файлов, которые можно загрузить.

Перечисления
FILE_TYPE_UNSPECIFIED Значение по умолчанию, если тип не указан или неизвестен в этой версии.
FILE_TYPE_CAMPAIGN Кампания.
FILE_TYPE_MEDIA_PRODUCT Медиа-продукт.
FILE_TYPE_INSERTION_ORDER Заказ на вставку.
FILE_TYPE_LINE_ITEM Позиция позиции.
FILE_TYPE_AD_GROUP Группа объявлений YouTube.
FILE_TYPE_AD Реклама на YouTube.
FILE_TYPE_LINE_ITEM_QA Формат позиции — QA.
FILE_TYPE_AD_GROUP_QA Группа объявлений YouTube — формат QA.

Тип фильтра

Возможные типы, по которым можно фильтровать.

Перечисления
FILTER_TYPE_UNSPECIFIED Значение по умолчанию, если тип не указан или неизвестен в этой версии.
FILTER_TYPE_NONE Если выбрано, фильтр к загрузке не применяется. Может использоваться только в том случае, если в CreateSdfDownloadTaskRequest указан Advertiser .
FILTER_TYPE_ADVERTISER_ID Идентификатор рекламодателя. Если выбран этот параметр, все идентификаторы фильтров должны быть идентификаторами рекламодателей, принадлежащими Partner , указанному в CreateSdfDownloadTaskRequest .
FILTER_TYPE_CAMPAIGN_ID Идентификатор кампании. Если выбран этот параметр, все идентификаторы фильтров должны быть идентификаторами кампаний, принадлежащих Advertiser или Partner указанному в CreateSdfDownloadTaskRequest .
FILTER_TYPE_MEDIA_PRODUCT_ID Идентификатор медиапродукта. Если выбран этот параметр, все идентификаторы фильтров должны быть идентификаторами медиапродуктов, принадлежащими Advertiser или Partner указанному в CreateSdfDownloadTaskRequest . Может использоваться только для загрузки FILE_TYPE_MEDIA_PRODUCT .
FILTER_TYPE_INSERTION_ORDER_ID Идентификатор заказа на вставку. Если выбран этот параметр, все идентификаторы фильтров должны быть идентификаторами заказов на вставку, принадлежащими Advertiser или Partner указанному в CreateSdfDownloadTaskRequest . Может использоваться только для загрузки FILE_TYPE_INSERTION_ORDER , FILE_TYPE_LINE_ITEM , FILE_TYPE_LINE_ITEM_QA , FILE_TYPE_AD_GROUP , FILE_TYPE_AD_GROUP_QA и FILE_TYPE_AD .
FILTER_TYPE_LINE_ITEM_ID Идентификатор позиции. Если выбрано, все идентификаторы фильтров должны быть идентификаторами позиций, принадлежащими Advertiser или Partner указанному в CreateSdfDownloadTaskRequest . Может использоваться только для загрузки FILE_TYPE_LINE_ITEM , FILE_TYPE_LINE_ITEM_QA , FILE_TYPE_AD_GROUP , FILE_TYPE_AD_GROUP_QA и FILE_TYPE_AD .

IdFilter

Параметр фильтрации, который фильтрует сущности по их идентификаторам.

JSON-представление 
{
  "campaignIds": [
    string
  ],
  "mediaProductIds": [
    string
  ],
  "insertionOrderIds": [
    string
  ],
  "lineItemIds": [
    string
  ],
  "adGroupIds": [
    string
  ],
  "adGroupAdIds": [
    string
  ],
  "lineItemQaIds": [
    string
  ],
  "adGroupQaIds": [
    string
  ]
}
Поля
campaignIds[]

string ( int64 format)

Кампании для загрузки по идентификатору. Все идентификаторы должны принадлежать одному Advertiser или Partner указанному в CreateSdfDownloadTaskRequest .

mediaProductIds[]

string ( int64 format)

Медиапродукты для загрузки по идентификатору. Все идентификаторы должны принадлежать одному Advertiser или Partner указанному в CreateSdfDownloadTaskRequest .

insertionOrderIds[]

string ( int64 format)

Заказы на размещение для загрузки по идентификатору. Все идентификаторы должны принадлежать одному Advertiser или Partner указанному в CreateSdfDownloadTaskRequest .

lineItemIds[]

string ( int64 format)

Позиции для загрузки по идентификатору. Все идентификаторы должны принадлежать одному Advertiser или Partner указанному в CreateSdfDownloadTaskRequest .

adGroupIds[]

string ( int64 format)

Группы объявлений YouTube для загрузки по идентификатору. Все идентификаторы должны принадлежать одному Advertiser или Partner указанному в CreateSdfDownloadTaskRequest .

adGroupAdIds[]

string ( int64 format)

Реклама YouTube для загрузки по идентификатору. Все идентификаторы должны принадлежать одному Advertiser или Partner указанному в CreateSdfDownloadTaskRequest .

lineItemQaIds[]

string ( int64 format)

Необязательно. Позиции по идентификатору для загрузки в формате QA. Все идентификаторы должны принадлежать одному Advertiser или Partner указанному в CreateSdfDownloadTaskRequest .

adGroupQaIds[]

string ( int64 format)

Необязательно. Группы объявлений YouTube по идентификатору для загрузки в формате QA. Все идентификаторы должны принадлежать одному Advertiser или Partner указанному в CreateSdfDownloadTaskRequest .

Фильтр источника инвентаря

Параметр фильтрации для фильтрации по сущностям источника инвентаря.

JSON-представление 
{
  "inventorySourceIds": [
    string
  ]
}
Поля
inventorySourceIds[]

string ( int64 format)

Источники инвентаря для загрузки по идентификатору. Все идентификаторы должны принадлежать одному Advertiser или Partner , указанному в CreateSdfDownloadTaskRequest . Оставьте поле пустым, чтобы загрузить все источники инвентаря для выбранного рекламодателя или партнера.