تعرض جميع الصفوف التي تطابق طلب بحث مصدر البحث.
قائمة الأخطاء الملموسة: AuthenticationError AuthorizationError ChangeEventError ChangeStatusError ClickViewError HeaderError InternalError QueryError QuotaError RequestError
طلب HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}/googleAds:searchStream
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
customerId |
مطلوبة. رقم تعريف العميل الذي يجري الاستعلام عنه. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"query": string,
"summaryRowSetting": enum ( |
الحقول | |
---|---|
query |
مطلوبة. سلسلة طلب البحث |
summaryRowSetting |
تحدِّد هذه السياسة ما إذا كان سيتم عرض صف ملخّص. ولا يتم عرض صف الملخّص تلقائيًا. وإذا لزم الأمر، سيتم إرسال صف الملخص كاستجابة بمفرده بعد عرض جميع نتائج الاستعلام الأخرى. |
نص الاستجابة
رسالة الرد لـ "GoogleAdsService.SearchStream
".
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "results": [ { object ( |
الحقول | |
---|---|
results[] |
قائمة الصفوف التي تطابق طلب البحث. |
fieldMask |
قناع الحقل الذي يمثل الحقول التي طلبها المستخدم. هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: |
summaryRow |
صف الملخص الذي يحتوي على ملخص المقاييس في النتائج يعني ملخص المقاييس تجميع المقاييس عبر جميع النتائج، ويمكن أن يكون التجميع هنا هو المجموع والمتوسط والمعدل وما إلى ذلك. |
requestId |
المعرّف الفريد للطلب الذي يُستخدَم لأغراض تصحيح الأخطاء. |
queryResourceConsumption |
يشير ذلك إلى مقدار الموارد المستخدَمة لعرض طلب البحث. يتم عرض queryResourceConsumption لصف "الملخّص" والردود غير "الملخّص" بشكل منفصل في الصفَين المعنيَين. يتم عرض queryResourceConsumption للردود غير "الملخّص" في المجموعة النهائية من النتائج. |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/adwords
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.