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