SearchStream

تحتوي 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'"
}