فایل داده های ساختاریافته را آپلود کنید

می‌توانید با آپلود فایل‌های داده ساختاریافته با استفاده از Display & Video 360، منابعی از جمله منابع YouTube را به‌صورت برنامه‌ریزی و انبوه ایجاد و به‌روزرسانی کنید. در این صفحه نحوه تهیه و آپلود یک فایل داده ساختاریافته با استفاده از API بحث می شود.

فقط پنج فایل داده ساختاریافته برای هر شناسه تبلیغ‌کننده می‌تواند توسط یک پروژه Google Cloud در یک روز آپلود شود.

یک فایل داده ساختاریافته برای آپلود آماده کنید

فایل‌های داده ساختاریافته آپلود شده باید نسخه‌های اصلاح شده فایل‌های داده ساختاریافته اخیراً از همان نوع فایل و از همان تبلیغ‌کننده باشند. با انجام به‌روزرسانی‌های زیر، فایل داده‌های ساختاریافته دانلود شده را برای بارگذاری آماده کنید:

  • برای هر منبع جدیدی که می خواهید ایجاد کنید، ورودی اضافه کنید.
  • هر ورودی موجود را برای منابعی که می خواهید به روز کنید، به روز کنید.
  • به منظور کاهش حجم فایل، سرعت بخشیدن به زمان پردازش و حذف احتمال بروز هر گونه به روز رسانی ناخواسته، ورودی هایی که جدید یا به روز نیستند را حذف کنید.

قبل از آپلود فایل موارد زیر را بررسی کنید:

  • فایل یک فایل CSV است.
  • همه ورودی‌های فایل مربوط به منابعی هستند که تحت همان تبلیغ‌کننده اصلی هستند.

یک فایل آپلود کنید

یک فایل داده ساختاریافته را با استفاده از روش advertisers.sdfuploadtasks.upload آپلود کنید. این درخواست یک Operation بارگذاری SDF ایجاد می کند. این عملیات طولانی مدت فایل آپلود شده را پردازش می کند، منابعی را بر اساس محتویات فایل ایجاد و به روز می کند، و فایل های نتیجه ای را تولید می کند که به روز رسانی های موفق و ناموفق را فهرست می کند.

در اینجا نحوه آپلود یک فایل داده ساختاریافته و بازیابی Operation حاصل آمده است:

# 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.')