Method: customers.searchAudienceInsightsAttributes

חיפושים של מאפייני קהל שבהם ניתן להשתמש כדי להפיק תובנות.

רשימת שגיאות שקרו: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

בקשת HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}:searchAudienceInsightsAttributes

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
customerId

string

חובה. המזהה של הלקוח.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "queryText": string,
  "customerInsightsGroup": string,
  "locationCountryFilters": [
    {
      object (LocationInfo)
    }
  ]
}
שדות
dimensions[]

enum (AudienceInsightsDimension)

חובה. סוגי המאפיינים שיש להחזיר.
queryText

string

חובה. שאילתה בטקסט חופשי. אם המאפיינים המבוקשים כוללים את המאפיינים CATEGORY או KNOWLEDGE_GRAPH, אז המאפיינים שהוחזרו עבור המאפיינים האלה יהיו תואמים למחרוזת הזו או יהיו קשורים אליה. לגבי מאפיינים אחרים, המערכת מתעלמת מהשדה הזה וכל המאפיינים הזמינים מוחזרים.
customerInsightsGroup

string

שם הלקוח המתוכנן. זהו ערך בהגדרת המשתמש.
locationCountryFilters[]

object (LocationInfo)

אם המאפיינים של SUB_COUNTRY_LOCATION הם אחד מהמאפיינים הנדרשים ומופיע שדה זה, המשמעות היא שהמאפיינים של SUB_COUNTRY_LOCATION שמוחזרים ימוקמו במדינות האלה. אם לא מזינים את השדה הזה, מאפייני המיקום לא מסוננים לפי מדינה. הגדרת שדה זה כאשר אין בקשה למאפיינים של SUB_COUNTRY_LOCATION תחזיר שגיאה.

גוף התשובה

הודעת תשובה לגבי AudienceInsightsService.ListAudienceInsightsAttributes.

אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "attributes": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ]
}
שדות
attributes[]

object (AudienceInsightsAttributeMetadata)

המאפיינים שתואמים לשאילתת החיפוש.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.