אחזור של ישויות בפורמט SDF. כדאי לנסות עכשיו.
שליחת בקשה
בקשת HTTP
POST https://www.googleapis.com/doubleclickbidmanager/v1/sdf/download
הרשאה
בקשה זו מחייבת הרשאה בהיקף הבא:
היקף |
---|
https://www.googleapis.com/auth/doubleclickbidmanager |
למידע נוסף, עיינו בדף אימות והרשאה.
גוף הבקשה
בגוף הבקשה, צריך לספק את הנתונים במבנה הבא:
{ "fileTypes": [ string ], "filterType": string, "filterIds": [ long ], "version": string }
שם הנכס | ערך | תיאור | הערות |
---|---|---|---|
fileTypes[] |
list |
סוגי הקבצים שיוחזרו. אם התבקשת INVENTORY_SOURCE, לא ניתן יהיה לבקש סוגי קבצים אחרים. הערכים המקובלים הם:
|
|
filterType |
string |
סוג המסנן המשמש לסינון הישויות לאחזור. ניתן להשתמש ב-PARTNER_ID וב-INVENTORY_SOURCE_ID רק בעת הורדת מקורות מלאי.
הערכים הקבילים הם:
|
|
filterIds[] |
list |
המזהים של סוג המסנן שצוין. משמש לסינון ישויות לאחזור. יש לציין לפחות מזהה אחד. ניתן להגדיר מזהה אחד בלבד לסוג המסנן ADVERTISER_ID . בסוגים של מסננים מסוג INSERTION_ORDER_ID או LINE_ITEM_ID , כל המזהים חייבים להיות מאותו מפרסם. |
|
version |
string |
גרסת SDF (שמות עמודות, סוגים, סדר) שבהם יוחזרו הישויות. ברירת המחדל היא 5 . |
תשובה
אם התגובה מוצלחת, שיטה זו תחזיר גוף תגובה בעל המבנה הבא:
{ "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 בהמשך. אפשר גם לנסות סייר עצמאי.