Method: googleAdsFields.search

تعرض جميع الحقول التي تطابق طلب البحث.

قائمة بالأخطاء الناتجة: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError

طلب HTTP

POST https://googleads.googleapis.com/v16/googleAdsFields:search

يستخدم عنوان URL بنية تحويل الترميز gRPC.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "query": string,
  "pageToken": string,
  "pageSize": integer
}
الحقول
query

string

مطلوبة. سلسلة طلب البحث
pageToken

string

الرمز المميّز للصفحة لاسترداده. في حال عدم تحديد أي خيار، سيتم عرض الصفحة الأولى من النتائج. استخدِم القيمة التي تم الحصول عليها من nextPageToken في الردّ السابق لطلب الحصول على الصفحة التالية من النتائج.
pageSize

integer

عدد العناصر المطلوب استردادها في صفحة واحدة. عندما يتم طلب صفحة كبيرة جدًا، قد يقرّر الخادم تقييد عدد الموارد التي يتم عرضها بشكل أكبر.

نص الاستجابة

رسالة الرد لـ "GoogleAdsFieldService.SearchGoogleAdsFields".

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "results": [
    {
      object (GoogleAdsField)
    }
  ],
  "nextPageToken": string,
  "totalResultsCount": string
}
الحقول
results[]

object (GoogleAdsField)

قائمة الحقول التي تطابق طلب البحث.
nextPageToken

string

الرمز المميّز لتقسيم النتائج على عدّة صفحات يُستخدم لاسترداد الصفحة التالية من النتائج. مرِّر محتوى هذه السلسلة كسمة pageToken للطلب التالي. لا يتم عرض nextPageToken للصفحة الأخيرة.
totalResultsCount

string (int64 format)

إجمالي عدد النتائج التي تطابق طلب البحث مع تجاهل عبارة LIMIT.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/adwords

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.