API Reference

يتم تنظيم مرجع واجهة برمجة التطبيقات هذا حسب نوع المورد. يحتوي كل نوع من أنواع الموارد على تمثيل بيانات واحد أو أكثر وطريقة واحدة أو أكثر.

أنواع الموارد

  1. الإحالة الناجحة
  2. التقارير
  3. الأعمدة المحفوظة

الإحالة الناجحة

للحصول على تفاصيل مورد التحويل، راجع صفحة تمثيل المورد.

الطريقة طلب HTTP الوصف
مُعرِّفات الموارد المنتظمة (URI) المنطبقة على https://www.googleapis.com/doubleclicksearch/v2، ما لم يُذكر خلاف ذلك
الحصول GET  /agency/agencyId/advertiser/advertiserId/engine/engineAccountId/conversion لاسترداد قائمة بالتحويلات من حساب محرك بحث DoubleClick.

معلمات طلب البحث المطلوبة: endDate وrowCount وstartDate وstartRow

getByCustomerId GET  /customer/customerId/conversion لاسترداد قائمة الإحالات الناجحة من حساب محرك بحث DoubleClick باستخدام رقم تعريفي لعميل "إعلانات شبكة البحث 360" جديد.

معلمات طلب البحث المطلوبة: endDate وrowCount وstartDate وstartRow

إدراج POST  /conversion لإدراج دفعة من الإحالات الناجحة الجديدة في DoubleClick Search.
تحديث PUT  /conversion تحديث دفعة من التحويلات في DoubleClick Search.
updateAvailability POST  /conversion/updateAvailability تعدّل بيانات مدى توفّر مجموعة من أنشطة Floodlight في DoubleClick Search.

التقارير

للحصول على تفاصيل حول موارد التقارير، راجع صفحة تمثيل المورد.

الطريقة طلب HTTP الوصف
مُعرِّفات الموارد المنتظمة (URI) المنطبقة على https://www.googleapis.com/doubleclicksearch/v2، ما لم يُذكر خلاف ذلك
إنشاء POST  /reports/generate إنشاء تقرير وعرضه على الفور.
الحصول GET  /reports/reportId استطلاعات رأي حول حالة طلب التقرير
getFile GET  /reports/reportId/files/reportFragment يتم تنزيل ملف تقرير بالترميز UTF-8.
getIdMappingFile GET  /agency/agencyId/advertiser/advertiserId/idmapping يتم تنزيل ملف CSV (مشفَّر بترميز UTF-8) يحتوي على تعيينات أرقام التعريف بين تجربة "إعلانات شبكة البحث 360" السابقة و"إعلانات شبكة البحث 360" الجديدة. بالنسبة إلى المعلِن المطلوب، يتضمّن الملف جميع الكيانات الفرعية (مثل حسابات محركات البحث والحملات والمجموعات الإعلانية وغيرها) التي تتوفّر في كلٍّ من تجربة "إعلانات شبكة البحث 360" السابقة و"إعلانات شبكة البحث 360" الجديدة.
طلب POST  /reports إدراج طلب تقرير في نظام إعداد التقارير.

الأعمدة المحفوظة

للحصول على تفاصيل حول مورد الأعمدة المحفوظة، اطلع على صفحة تمثيل المورد.

الطريقة طلب HTTP الوصف
مُعرِّفات الموارد المنتظمة (URI) المنطبقة على https://www.googleapis.com/doubleclicksearch/v2، ما لم يُذكر خلاف ذلك
list GET  /agency/agencyId/advertiser/advertiserId/savedcolumns استرداد قائمة الأعمدة المحفوظة لمعلن محدد.