تتضمّن 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'" }