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 olarak oluşturabilir ve güncelleyebilirsiniz. Bu sayfada, API'yi kullanarak bir Yapılandırılmış Veri Dosyası'nın nasıl hazırlanacağı ve yükleneceği ele alınmaktadır.

Bir Google Cloud projesi, reklamveren kimliği başına günde yalnızca beş Yapılandırılmış Veri Dosyası yükleyebilir.

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

Yüklenen Yapılandırılmış Veri Dosyaları, aynı dosya türüne 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 azaltmak, işleme süresini kısaltmak ve istenmeyen güncelleme olasılığını ortadan kaldırmak için yeni veya güncellenmemiş girişleri kaldırın.

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

  • Dosya bir CSV dosyası.
  • Dosyadaki tüm girişler, aynı üst reklamverenin altındaki kaynaklar içindir.

Dosya yükleyin

advertisers.sdfuploadtasks.upload yöntemini kullanarak bir Yapılandırılmış Veri Dosyası yükleyin. Bu istek, SDF yükleme görevi Operation oluşturur. Uzun süren bu 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 elde edilen Operation'yi alma işlemini aşağıdaki şekilde gerçekleştirebilirsiniz:

# 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.')
Önceki
Genel bakış
Sonraki
Anket görevi