Method: advertisers.sdfuploadtasks.upload

Tworzy zadanie przesyłania pliku SDF. Zwraca wartość Operation.

Zadanie przesyłania pliku SDF to długotrwała operacja asynchroniczna. Typ operacji metadata to SdfUploadTaskMetadata. Jeśli żądanie zostało wykonane, operacja response ma typ SdfUploadTask. Odpowiedź nie będzie zawierać plików wynikowych, które można następnie pobrać za pomocą media.download.

Stan operacji można pobrać za pomocą sdfuploadtask.operations.get.

Wszelkie błędy można znaleźć w error.message. Wartość atrybutu error.details powinna być pusta.

Żądanie HTTP

  • Identyfikator URI przesyłania – dotyczy żądań przesyłania multimediów:
    POST https://displayvideo.googleapis.com/upload/v4/advertisers/{advertiserId}/sdfuploadtasks
  • Identyfikator URI metadanych, w przypadku żądań tylko z metadanymi:
    POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/sdfuploadtasks

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
advertiserId

string (int64 format)

Wymagane. Identyfikator reklamodawcy, którego dotyczy przesyłany plik SDF.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "filename": string,
  "sdfVersion": enum (SdfVersion)
}
Pola
filename

string

Wymagane. Nazwa pliku zasobu, w tym rozszerzenie pliku. Nazwa pliku musi być zakodowana w formacie UTF-8 i mieć maksymalny rozmiar 240 bajtów.
sdfVersion

enum (SdfVersion)

Wymagane. Wersja SDF przesłanego pliku. Jeśli ustawisz wartość SDF_VERSION_UNSPECIFIED, domyślnie zostanie wybrana wersja określona przez zidentyfikowanego reklamodawcę. Reklamodawca dziedziczy wersję SDF od swojego partnera, chyba że skonfigurowano inaczej.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Operation.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.