Yapılandırılmış Veri Dosyası Yükleme

Display & Video 360 API'yi kullanarak yapılandırılmış veri dosyaları yükleyerek YouTube kaynakları da dahil olmak üzere kaynakları programatik olarak ve toplu şekilde oluşturup güncelleyebilirsiniz. Bu sayfada, API kullanarak Yapılandırılmış Veri Dosyası'nın nasıl hazırlanacağı ve yükleneceği açıklanmaktadır.

Bir Google Cloud projesi tarafından bir günde yalnızca otuz yapılandırılmış veri dosyası yüklenebilir.

Yüklemek için yapılandırılmış veri dosyası hazırlama

Yüklenen Yapılandırılmış Veri Dosyaları, aynı dosya türünde ve aynı reklamverene ait, yakın zamanda indirilen Yapılandırılmış Veri Dosyaları'nın değiştirilmiş sürümleri olmalıdır. İndirilen yapılandırılmış veri dosyasını aşağıdaki güncellemeleri yaparak yüklemeye hazırlayın:

• Oluşturmak istediğiniz yeni kaynaklar için girişler ekleyin.
• Güncellemek istediğiniz kaynaklarla ilgili mevcut girişleri güncelleyin.
• Dosya boyutunu küçültmek, işlem süresini hızlandırmak ve yanlışlıkla güncelleme yapılma olasılığını ortadan kaldırmak için yeni olmayan veya güncellenmemiş girişleri kaldırın.

İpucu: Yükleme için SDF hazırlarken yakın zamanda indirilmiş bir SDF kullanın. SDF indirildikten sonra değiştirilen kaynaklar, dosya yükleme sırasında başarıyla güncellenmeyebilir.

Dosyayı yüklemeden önce aşağıdakileri doğrulayın:

• Dosya bir CSV dosyasıdır.
• Dosyadaki tüm girişler, aynı üst reklamverene ait kaynaklar içindir.
• Dosyada 10.000'den fazla giriş bulunmuyor.

Dosya yükleyin

advertisers.sdfuploadtasks.upload yöntemini kullanarak yapılandırılmış veri dosyası yükleyin. Bu istek, Operation kimlikli bir SDF yükleme görevi oluşturur. Bu uzun süren işlem, yüklenen dosyayı işler, dosya içeriğine göre kaynaklar oluşturup günceller ve başarılı ve başarısız güncellemeleri listeleyen sonuç dosyaları oluşturur.

Yapılandırılmış veri dosyasını yükleme ve sonuçtaki Operation'ı alma adımları aşağıda açıklanmıştır:

Uyarı: advertisers.sdfuploadtasks.upload yöntemi, bir Google Cloud projesi tarafından günde reklamveren başına yalnızca otuz kez başarıyla çağrılabilir. Bir gün, ABD Pasifik saat diliminde (PST) gece yarısında başlar. Yönteme yapılan bir istek başarısız olursa bu istek kotanızdan düşülmez.

# Import the object used as the media body for the upload request.
from apiclient.http import MediaFileUpload

# Provide the parent advertiser ID for the resources in the SDF.
# The ID value must be a str and not an int.
advertiser_id = advertiser-id

# Provide the filename and local path to the media file.
sdf_filename = sdf-filename
sdf_path = sdf-path

# Create the request body.
body = {
  'filename': sdf_filename,
  'advertiserId': advertiser_id
}

# Create the upload object and use a default MIME type if not identified.
media = MediaFileUpload(sdf_path)
if not media.mimetype():
  media = MediaFileUpload(sdf_filename,'application/octet-stream')

# Upload the structured data file.
upload_response = service.advertisers().sdfuploadtasks().upload(
  advertiserId=advertiser_id,
  body=body,
  media_body=media
).execute()

# Print resulting Operation name.
print(f'SDF was successfully uploaded. Operation {upload_response["name"]} was '
       'created to process the uploaded file.')