موجودیت ها را در قالب 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 درخواست شود، هیچ نوع فایل دیگری ممکن است درخواست نشود. مقادیر قابل قبول عبارتند از:
| |
filterType | string | نوع فیلتری که برای فیلتر کردن موجودیتها برای واکشی استفاده میشود. PARTNER_ID و INVENTORY_SOURCE_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 زیر برای فراخوانی این روش در دادههای زنده و دیدن پاسخ استفاده کنید. از طرف دیگر، اکسپلورر مستقل را امتحان کنید.