تحتوي Google Ads API على تقارير موحَّدة لاسترداد السمات والمقاييس. الآلية التي تتيح لك إنشاء طلبات بحث باستخدام طلب بحث "إعلانات Google" اللغة: يمكّن ذلك الاستعلامات المعقدة التي يمكن أن ترجع كميات كبيرة من البيانات حول حسابات "إعلانات Google" الفردية
يمكنك إنشاء طلبات بحث باستخدام إحدى الطريقتَين Search أو SearchStream.
تتيح كلتا الطريقتين استخدام نفس الاستعلامات وتعرض نتائج مكافئة. تشير رسالة الأشكال البيانية
تعرض طريقة Search البيانات في صفحات ذات حجم ثابت يتكوّن من 10,000 صف، ما يتيح لك
لتكرار مجموعة نتائج باستخدام عملية التقسيم على صفحات. وقد يكون هذا مفيدًا في حالة
النطاق الترددي أو ظروف الشبكة غير الموثوقة، مثل تقسيم جزء كبير
النتيجة مجموعة إلى استجابات أصغر يمكن إعادة جلبها إذا كان الاتصال
وتفقدها. أمّا طريقة SearchStream، فتنقل النتيجة كاملةً.
إرجاعها في رد واحد، ما قد يكون أكثر كفاءة للبيانات المجمّعة
استرداد البيانات.
يستخدم كل من Search وSearchStream عنوان URL الأساسي نفسه:
https://googleads.googleapis.com/v17/customers/CUSTOMER_ID/googleAds
POST /v17/customers/CUSTOMER_ID/googleAds:search HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_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'"
}
إذا كان هناك أكثر من 10,000 صف في النتائج، تكون السمة nextPageToken
تم إرجاعها في الرد:
{
"results": [
// ...
// ...
// ...
],
"nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B",
"fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status"
}
يؤدي تكرار طلب البحث نفسه مع إضافة pageToken بالقيم من
يجلب الطلب السابق الصفحة التالية من النتائج:
POST /v17/customers/CUSTOMER_ID/googleAds:search HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_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'",
"pageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B"
}
لاستخدام طريقة SearchStream التي تعرض جميع النتائج في مجموعة بث واحدة
استجابة، غيِّر طريقة الخدمة في عنوان URL إلى searchStream
(pageSize وpageToken غير مطلوبَين بحلول SearchStream):
POST /v17/customers/CUSTOMER_ID/googleAds:searchStream HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_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'"
}