سيتم إيقاف واجهة برمجة التطبيقات السابقة لإعداد تقارير "إعلانات شبكة البحث 360" وسيتم إيقافها في 30 حزيران (يونيو) 2024. تجدر الإشارة إلى أنّ واجهة برمجة تطبيقات الإحالات الناجحة في "إعلانات شبكة البحث 360" لم تتأثر بهذه المشكلة، وستستمر في إتاحتها. من المفترض أن تستخدم جميع عمليات تطوير التقارير الجديدة Search Ads 360 Reporting API الجديدة، وهي متاحة الآن كإصدار تجريبي مفتوح. ننصحك بشدة ببدء نقل أي عمليات تنفيذ حالية في "إعلانات شبكة البحث 360" إلى واجهة برمجة التطبيقات الجديدة. اطّلِع على بدء استخدام "إعلانات شبكة البحث 360" الجديدة ودليل نقل البيانات الجديدتَين للحصول على مزيد من المعلومات.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Switch to English

API Reference

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

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

للاطّلاع على تفاصيل "مورد الإحالة الناجحة"، راجع صفحة تمثيل الموارد.

الطريقة	طلب 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 Search باستخدام رقم تعريفي لعميل "إعلانات شبكة البحث 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، ما لم يُذكر خلاف ذلك
generate	`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".
طلب	`POST /reports`	يُدرج طلب إبلاغ في نظام إعداد التقارير.

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

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