Method: customers.searchAudienceInsightsAttributes

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

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

בקשת HTTP

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