Method: advertisers.sdfuploadtasks.upload

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

Задача загрузки SDF — это длительная асинхронная операция. Тип metadata этой операции — SdfUploadTaskMetadata . Если запрос успешен, тип response операции — SdfUploadTask . Ответ не будет включать результирующие файлы, которые затем можно будет получить с помощью media.download .

Состояние операции можно получить с помощью sdfuploadtask.operations.get .

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

HTTP-запрос

  • URI загрузки для запросов на загрузку мультимедиа:
    POST https://displayvideo.googleapis.com/upload/v4/advertisers/{advertiserId}/sdfuploadtasks
  • URI метаданных для запросов только метаданных:
    POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/sdfuploadtasks

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

Параметры пути

Параметры
advertiserId

string ( int64 format)

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

Тело запроса

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

JSON-представление 
{
  "filename": string,
  "sdfVersion": enum (SdfVersion)
}
Поля
filename

string

Необходимый. Имя файла ресурса, включая расширение файла. Имя файла должно быть в кодировке UTF-8 с максимальным размером 240 байт.

sdfVersion

enum ( SdfVersion )

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

Тело ответа

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

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

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

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

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