سيتم إيقاف Search Ads 360 Reporting API السابقة نهائيًا وإيقافها في 30 حزيران (يونيو) 2024. يُرجى العلم أنّ Search Ads 360 Conversion API لم تتأثر بهذه المشكلة وستظلّ متاحة. يجب أن تستخدم جميع عمليات تطوير إعداد التقارير الجديدة Search Ads 360 Reporting API الجديدة.

اعتبارًا من نيسان (أبريل) 2024، سيظهر خطأ غير متوافق مع ApiVersion عند طلب تقرير. اطّلع على التفاصيل هنا.

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

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

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`	يُدرج طلب إبلاغ في نظام إعداد التقارير.

SavedColumns

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

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