إنشاء مهمة تنزيل

قدِّم طلبًا إلى sdfdownloadtasks.create لإنشاء مهمة تنزيل تُنشئ ملفات البيانات المنظَّمة (SDF).

حدِّد ملفات SDF باستخدام الحقول التالية في طلبك:

• ‫partnerId أو advertiserId: حقلَان متناقضان يحدّدان موردًا رئيسيًا (إما شريك أو معلِن) للموارد التي تملأ ملفات SDF.
• ‫version: إصدار SDF المراد استخدامه، إذا كان مختلفًا عن الإصدار التلقائي الذي تم ضبطه على مستوى الشريك أو المعلِن.
• ‫parentEntityFilter أو idFilter أو inventorySourceFilter: حقول حصرية تُحدِّد الفلتر المستخدَم لتحديد أنواع الملفات والموارد المطلوب تضمينها.

استخدِم مقتطف الرمز البرمجي هذا لإنشاء مهمة تنزيل لملفّات بيانات "العناصر المنظَّمة" الخاصة بطلب الإدراج وملفّات "العناصر المنظَّمة" الخاصة بصفوف الإعلانات ضمن المعلِن المحدّد وضمن نطاق أرقام تعريف الحملات المقدَّمة:

تحذير: يمكن لمستخدم واحد تنفيذ عشرين عملية 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.')