تتضمّن Search Ads 360 Reporting API آلية موحّدة لاسترداد السمات وإعداد تقارير المقاييس تتيح لك إنشاء طلبات بحث باستخدام لغة طلبات البحث في "إعلانات شبكة البحث 360". يتيح ذلك طلبات بحث معقّدة يمكنها عرض كميات كبيرة من البيانات عن حسابات "إعلانات شبكة البحث 360" الفردية.
يمكنك إنشاء طلبات بحث باستخدام إحدى الطريقتَين Search أو SearchStream.
تتيح كلتا الطريقتَين طلبات البحث نفسها وتُظهر نتائج مماثلة. وتعرض الطريقة Search البيانات بأحجام صفحات قابلة للتخصيص، ما يتيح لك تكرار مجموعة النتائج باستخدام التقسيم على صفحات. وقد يفيد ذلك في انخفاض معدل نقل البيانات أو ظروف الشبكة غير الموثوقة، فعلى سبيل المثال، لتقسيم مجموعة نتائج كبيرة إلى استجابات أصغر يمكن إعادة جلبها في حالة فقدان الاتصال. في المقابل، تُعيد طريقة
SearchStream بث مجموعة النتائج بالكامل في
ردّ واحد، ما قد يكون أكثر فعالية لاسترداد البيانات المجمّعة.
يستخدم كلّ من Search وSearchStream عنوان URL الأساسي نفسه:
https://searchAds360.googleapis.com/v0/customers/CUSTOMER_ID/searchAds360
تستخدِم طريقة البحث المستندة إلى الصفحة مَعلمة pageSize اختيارية تحدّ من
عدد النتائج التي يتم عرضها في استجابة واحدة من واجهة برمجة التطبيقات.
POST /v0/customers/CUSTOMER_ID/searchAds360:search HTTP/1.1 Host: searchAds360.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN { "pageSize": 10000, "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'" }
إذا كان هناك صفوف أكثر من pageSize في النتائج، يتم عرض nextPageToken في الرد:
{ "results": [ // ... // ... // ... ], "nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B", "fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status" }
يؤدي تكرار طلب البحث نفسه مع إضافة pageToken بالقيمة أعلاه إلى جلب
الصفحة التالية من النتائج:
POST /v0/customers/CUSTOMER_ID/searchAds360:search HTTP/1.1 Host: searchads360.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN { "pageSize": 10000, "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'", "pageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B" }
لاستخدام طريقة SearchStream التي تعرض جميع النتائج في استجابة واحدة يتم بثّها، ما عليك سوى تغيير طريقة الخدمة في عنوان URL إلى searchStream
(pageSize وpageToken غير مطلوبَين من قِبل SearchStream):
POST /v0/customers/CUSTOMER_ID/searchAds360:searchStream HTTP/1.1 Host: searchads360.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN { "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'" }