Medya yükleme

Medya yükleme özelliği, Display & Video 360'ta kullanabileceğiniz verileri saklamanıza olanak tanır. Yüklemek isteyebileceğiniz veri türleri arasında fotoğraflar, videolar ve ZIP dosyaları yer alır.

Yükleme seçenekleri

Display & Video 360 API, belirli ikili veri veya medya türlerini yüklemenize olanak tanır. Yükleyebileceğiniz verilerin özellikleri, medya yüklemesi gerektiren tüm görevler için geliştirici kılavuzunda ayrıntılı olarak açıklanmıştır:

  • Maksimum yükleme dosyası boyutu: Bu yöntemle depolayabileceğiniz maksimum veri miktarı.
  • Kabul edilen medya MIME türleri: Bu yöntemle depolayabileceğiniz ikili veri türleri.

Yükleme isteklerini aşağıdaki yöntemlerden herhangi biriyle yapabilirsiniz. uploadType parametresiyle kullandığınız yöntemi belirtin.

  • Kolay yükleme: uploadType=media. Yaklaşık 5 MB veya daha küçük dosyalar için hızlı aktarım
  • Çok parçalı yükleme: uploadType=multipart. Dosyalar ve ilgili meta veriler için hızlı aktarım. Dosyayı ve meta verileri tek bir istekte aktarır.

Medya yüklerken /upload URI'si kullanırsınız. Medya verilerinin kendisini aktarırken bu URI'yi kullanın.

Örnek:

  POST /upload/media/resource-name

Kolay yükleme

Dosya yüklemenin en basit yöntemi, basit bir yükleme isteğidir. Bu seçenek aşağıdaki durumlarda iyi bir seçimdir:

  • Gerekirse dosya tekrar yüklenebilecek kadar küçüktür.
  • Gönderilecek meta veri yok. Meta veriler gerekli değilse veya isteğin başka bir yerinde yer alıyorsa bu durum geçerli olabilir.

Basit yüklemeyi kullanmak için yöntemin /upload URI'sine POST veya PUT isteğinde bulunun ve uploadType=media sorgu parametresini ekleyin. Örneğin:

  POST https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media

Basit bir yükleme işlemi yaparken kullanılacak HTTP üstbilgileri şunlardır:

  • Content-Type. Yöntemin kabul ettiği medya veri türlerinden birine ayarlayın.
  • Content-Length. Yüklediğiniz bayt sayısına ayarlayın. Parçalı aktarım kodlaması kullanıyorsanız gerekli değildir.

Çok parçalı yükleme

Yüklenen verilerle birlikte gönderilecek meta verileriniz varsa multipart/related isteğinde bulunabilirsiniz. Gönderdiğiniz veriler gerekirse tekrar yüklenebilecek kadar küçükse bu seçeneği tercih edebilirsiniz.

Çok parçalı yüklemeyi kullanmak için yöntemin /upload URI'sine POST veya PUT isteği gönderin ve uploadType=multipart sorgu parametresini ekleyin. Örneğin:

  POST https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart

Çok parçalı yükleme isteğinde bulunurken kullanılacak üst düzey HTTP başlıkları şunlardır:

  • Content-Type. multipart/related olarak ayarlayın ve isteğin bölümlerini tanımlamak için kullandığınız sınır dizesini ekleyin.
  • Content-Length. İstek gövdesindeki toplam bayt sayısına ayarlanır. İsteğin medya kısmı, bu yöntem için belirtilen maksimum dosya boyutundan küçük olmalıdır.

İsteğin gövdesi, multipart/related içerik türü olarak biçimlendirilir [RFC2387] ve tam olarak iki bölüm içerir. Bölümler, bir sınır dizesiyle tanımlanır ve son sınır dizesini iki kısa çizgi izler.

Çok parçalı isteğin her bölümü için ek bir Content-Type başlığı gerekir:

  1. Meta veri bölümü: Önce gelmeli ve Content-Type kabul edilen meta veri biçimlerinden biriyle eşleşmelidir.
  2. Medya bölümü: İkinci sırada olmalı ve Content-Type, yöntemin kabul ettiği medya MIME türlerinden biriyle eşleşmelidir.

Örnekler

Çeşitli görevleri yerine getirmek için Display & Video 360 API'yi kullanarak medya yüklersiniz. Bu bölümde, curl istekleri şeklinde örnekler verilmektedir.

Reklam öğesi yükleme

Reklam öğesi yükleme:

curl --request POST \
  'https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart' \
  --header 'Authorization: Bearer access-token' \
   -F "data={\"filename\": \"asset-filename\"};type=application/json;charset=UTF-8" \
   -F "file=@asset-path;type=asset-mime-type"

Daha fazla bilgi ve kod örnekleri için Reklam öğelerini yükleme rehberine bakın.

Özel teklif verme komut dosyası yükleme

Senaryo dosyası yüklemek için:

curl --request POST \
  'https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media' \
  -H 'authorization: Bearer access-token' \
  -H 'Content-Type: text/plain' \
  --data-binary @script-path

Daha fazla bilgi ve kod örnekleri için Yükleme komut dosyası kılavuzunu inceleyin.