Method: googleAdsFields.search

מחזירה את כל השדות שתואמים לשאילתת החיפוש.

רשימה של שגיאות הטמעה: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError

בקשת HTTP

POST https://googleads.googleapis.com/v14/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.