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

أرسِل طلب 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.')