نعمل حاليًا على نقل مجموعة فرعية من أنواع التقارير من التقارير بلا إنترنت إلى التقارير الفورية. بعد نقل بيانات المستخدِم، ستتضمّن ردود
queries.list
تقارير فورية حالية. ويمكنك الاطّلاع على
مشاركة المدونة للحصول على مزيد من المعلومات.
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 |
|
|
جرّب الآن
يمكنك استخدام "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الردّ.
ويمكنك بدلاً من ذلك تجربة
مستقل
Explorer (المستكشف):
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-08-22 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-08-22 (حسب التوقيت العالمي المتفَّق عليه)"],[[["The SDF Download service of the Bid Manager API is discontinued and users should transition to the DV360 API for similar functionality."],["The DV360 API's SDF download requires authorization with the `https://www.googleapis.com/auth/doubleclickbidmanager` scope."],["Users can retrieve entities like campaigns, insertion orders, line items, ad groups, ads, and inventory sources in SDF format using the new API."],["The request body for the DV360 API allows for filtering downloaded entities by type and ID, and specifying the SDF version for the output."]]],["The SDF Download service is deprecated; users should migrate to the DV360 API. To retrieve entities in SDF format, a POST request is made to the specified endpoint, requiring authorization. The request body includes `fileTypes` (e.g., AD, CAMPAIGN), `filterType` (e.g., ADVERTISER_ID), `filterIds` (IDs corresponding to filter type), and `version`. The response contains strings representing downloaded entities such as `insertionOrders`, `lineItems`, `ads`, `campaigns`, `adGroups` and `inventorySources` in SDF format.\n"]]