Method: customers.searchAudienceInsightsAttributes

Wyszukuje atrybuty odbiorców, na podstawie których można generować statystyki.

Lista zgłoszonych błędów: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

To pole jest wymagane. Identyfikator klienta.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "queryText": string,
  "customerInsightsGroup": string,
  "locationCountryFilters": [
    {
      object (LocationInfo)
    }
  ]
}
Pola
dimensions[]

enum (AudienceInsightsDimension)

To pole jest wymagane. Typy atrybutów, które mają zostać zwrócone.
queryText

string

To pole jest wymagane. Zapytanie dowolnego tekstu. Jeśli żądane wymiary obejmują Atrybuty CATEGORY lub KNOWLEDGE_GRAPH, zwracane atrybuty dla tych wymiarów będą pasować do tego ciągu lub być z nim powiązane. W przypadku innych wymiarów to pole jest ignorowane, a zwracane są wszystkie dostępne atrybuty.
customerInsightsGroup

string

Nazwa planowanego klienta. Jest to wartość zdefiniowana przez użytkownika.
locationCountryFilters[]

object (LocationInfo)

Jeśli jednym z żądanych wymiarów są atrybuty SUB_COUNTRY_LOCATION, a to pole występuje, zwrócone atrybuty SUB_COUNTRY_LOCATION będą znajdować się w tych krajach. Jeśli to pole jest puste, atrybuty lokalizacji nie są filtrowane według kraju. Ustawienie tego pola, gdy nie są wymagane atrybuty SUB_COUNTRY_LOCATION, spowoduje zwrócenie błędu.

Treść odpowiedzi

Wiadomość z odpowiedzią na temat: AudienceInsightsService.ListAudienceInsightsAttributes.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "attributes": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ]
}
Pola
attributes[]

object (AudienceInsightsAttributeMetadata)

Atrybuty pasujące do wyszukiwanego hasła.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.