Sdf: download

אחזור של ישויות בפורמט SDF. כדאי לנסות עכשיו.

שליחת בקשה

בקשת HTTP

POST https://www.googleapis.com/doubleclickbidmanager/v1.1/sdf/download

הרשאה

בקשה זו מחייבת הרשאה בהיקף הבא:

היקף
https://www.googleapis.com/auth/doubleclickbidmanager

למידע נוסף, עיינו בדף אימות והרשאה.

גוף הבקשה

בגוף הבקשה, צריך לספק את הנתונים במבנה הבא:

{
  "fileTypes": [
    string
  ],
  "filterType": string,
  "filterIds": [
    long
  ],
  "version": string
}
שם הנכס ערך תיאור הערות
fileTypes[] list סוגי הקבצים שיוחזרו. אם התבקשת INVENTORY_SOURCE, לא ניתן יהיה לבקש סוגי קבצים אחרים.

הערכים המקובלים הם:
  • 'AD'
  • 'AD_GROUP'
  • 'CAMPAIGN'
  • 'INSERTION_ORDER'
  • 'INVENTORY_SOURCE'
  • 'LINE_ITEM'
filterType string סוג המסנן המשמש לסינון הישויות לאחזור. ניתן להשתמש ב-PARTNER_ID וב-INVENTORY_SOURCE_ID רק בעת הורדת מקורות מלאי.

הערכים הקבילים הם:
  • 'ADVERTISER_ID'
  • 'CAMPAIGN_ID'
  • 'INSERTION_ORDER_ID'
  • 'INVENTORY_SOURCE_ID'
  • 'LINE_ITEM_ID'
  • 'PARTNER_ID'
filterIds[] list המזהים של סוג המסנן שצוין. משמש לסינון ישויות לאחזור. יש לציין לפחות מזהה אחד. ניתן להגדיר מזהה אחד בלבד לסוג המסנן ADVERTISER_ID. בסוגים של מסננים מסוג INSERTION_ORDER_ID או LINE_ITEM_ID, כל המזהים חייבים להיות מאותו מפרסם.
version string גרסת SDF (שמות עמודות, סוגים, סדר) שבהם יוחזרו הישויות. ברירת המחדל היא 5.3.

תשובה

אם התגובה מוצלחת, שיטה זו תחזיר גוף תגובה בעל המבנה הבא:

{
  "campaigns": string,
  "insertionOrders": string,
  "lineItems": string,
  "adGroups": string,
  "ads": string,
  "inventorySources": string
}
שם הנכס ערך תיאור הערות
insertionOrders string אוחזרו הזמנות הזנה בפורמט SDF.
lineItems string הפריטים אוחזרו בפורמט SDF.
adGroups string קבוצות המודעות אוחזרו בפורמט SDF.
ads string המודעות אוחזרו בפורמט SDF.
campaigns string אוחזרו קמפיינים בפורמט SDF.
inventorySources string

רוצה לנסות?

כדי לקרוא לשיטה הזו על נתונים בזמן אמת ולראות את התגובה, צריך להשתמש ב-APIs Explorer בהמשך. אפשר גם לנסות סייר עצמאי.