ایجاد وظیفه دانلود

یک درخواست sdfdownloadtasks.create ایجاد کنید تا یک وظیفه دانلود ایجاد شود که فایل‌های داده ساختاریافته (SDF) تولید کند.

SDF های خود را با استفاده از فیلدهای زیر در درخواست خود تعریف کنید:

• partnerId یا advertiserId : فیلدهای ناسازگار که یک منبع والد (شریک یا تبلیغ‌کننده) را برای منابع موجود در SDFها تعریف می‌کنند.
• version : نسخه SDF مورد استفاده، در صورتی که با نسخه پیش‌فرض تنظیم‌شده در سطح شریک یا تبلیغ‌کننده متفاوت باشد.
• parentEntityFilter ، idFilter یا inventorySourceFilter : فیلدهای منحصر به فرد که فیلتر مورد استفاده برای مشخص کردن انواع فایل‌ها و منابع مورد نیاز برای گنجاندن را تعیین می‌کنند.

از این قطعه کد برای ایجاد یک وظیفه دانلود برای Insertion Order و Line Item Structured Data Files تحت تبلیغ‌کننده داده شده و در محدوده شناسه‌های کمپین ارائه شده استفاده کنید:

هشدار: یک کاربر محدود به اجرای بیست عملیات sdfdownloadtask به طور همزمان است. تلاش برای ایجاد عملیات بیشتر منجر به خطا خواهد شد.

# Provide the ID of the parent advertiser of the resources to retrieve.
advertiser_id = advertiser-id

# Provide the Structured Data Files version to download.
sdf_version = sdf-version

# Provide the IDs of the parent campaigns of the resources to retrieve.
campaign_ids = [campaign-id, ...]

# Create the request body.
body = {
  'version': sdf_version,
  'advertiserId': advertiser_id,
  'parentEntityFilter': {
    'fileType': ["FILE_TYPE_INSERTION_ORDER","FILE_TYPE_LINE_ITEM"],
    'filterType': "FILTER_TYPE_CAMPAIGN_ID",
    'filterIds': campaign_ids
  }
}

# Create the operation.
operation = service.sdfdownloadtasks().create(body=body).execute()

# Print resulting operation name.
print(f'Operation {operation["name"]} was created.')