יצירת משימה להורדה

שולחים בקשה מסוג sdfdownloadtasks.create כדי ליצור משימה להורדה שיוצרת קובצי נתונים מובְנים (SDF).

מגדירים את קובצי ה-SDF באמצעות השדות הבאים בבקשה:

• partnerId או advertiserId: שדות בלעדיים שמגדירים משאב הורה (שותף או מפרסם) למשאבים שמאכלסים את קובצי ה-SDF.
• version: גרסת ה-SDF שבה רוצים להשתמש, אם היא שונה מברירת המחדל שמוגדרת ברמת השותף או המפרסם.
• parentEntityFilter, ‏ idFilter או inventorySourceFilter: שדות בלעדיים שמקצים את המסנן שמשמש לציון סוגי הקבצים והמשאבים שרוצים לכלול.

אפשר להשתמש בקטע הקוד הזה כדי ליצור משימה להורדה של קובצי נתונים מובְנים של הזמנות להצגת מודעות ופריטי שורה במפרסם הנתון, במסגרת מזהי הקמפיינים שצוינו:

אזהרה: משתמש יחיד מוגבל ל-20 פעולות 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.')