Method: advertisers.sdfuploadtasks.upload

SDF Yükleme Görevi oluşturur. Bir Operation döndürür.

SDF Yükleme Görevi, uzun süren, eşzamansız bir işlemdir. Bu işlemin metadata türü SdfUploadTaskMetadata. İstek başarılı olursa işlemin response türü SdfUploadTask olur. Yanıt, oluşturulan dosyaları içermez. Bu dosyalar daha sonra media.download kullanılarak alınabilir.

İşlemin durumu sdfuploadtask.operations.get ile alınabilir.

Hataları error.message dosyasında bulabilirsiniz. error.details değerinin boş olması gerektiğini unutmayın.

HTTP isteği

  • Medya yükleme istekleri için yükleme URI'si:
    POST https://displayvideo.googleapis.com/upload/v4/advertisers/{advertiserId}/sdfuploadtasks
  • Yalnızca meta veri istekleri için meta veri URI'si:
    POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/sdfuploadtasks

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
advertiserId

string (int64 format)

Zorunlu. SDF'nin yükleneceği reklamverenin kimliği.

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "filename": string,
  "sdfVersion": enum (SdfVersion)
}
Alanlar
filename

string

Zorunlu. Dosya uzantısı dahil olmak üzere öğenin dosya adı. Dosya adı, UTF-8 kodlu ve en fazla 240 bayt boyutunda olmalıdır.
sdfVersion

enum (SdfVersion)

Zorunlu. Yüklenen dosyanın SDF sürümü. SDF_VERSION_UNSPECIFIED olarak ayarlanırsa varsayılan olarak tanımlanan reklamveren tarafından belirtilen sürüm kullanılır. Reklamveren, aksi belirtilmediği sürece SDF sürümünü iş ortağından devralır.

Yanıt gövdesi

Başarılıysa yanıt metni, Operation öğesinin bir örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.