REST Resource: googleAdsFields

Zasób: GoogleAdsField

Pole lub zasób (artefakt) używane przez usługę GoogleAdsService.

Zapis JSON
{
  "resourceName": string,
  "category": enum (GoogleAdsFieldCategory),
  "selectableWith": [
    string
  ],
  "attributeResources": [
    string
  ],
  "metrics": [
    string
  ],
  "segments": [
    string
  ],
  "enumValues": [
    string
  ],
  "dataType": enum (GoogleAdsFieldDataType),
  "name": string,
  "selectable": boolean,
  "filterable": boolean,
  "sortable": boolean,
  "typeUrl": string,
  "isRepeated": boolean
}
Pola
resourceName

string

Tylko dane wyjściowe. Nazwa zasobu artefaktu. Nazwy zasobów artefaktów mają postać:

googleAdsFields/{name}

category

enum (GoogleAdsFieldCategory)

Tylko dane wyjściowe. Kategoria artefaktu.

selectableWith[]

string

Tylko dane wyjściowe. Nazwy wszystkich zasobów, segmentów i wskaźników, które można wybrać przy użyciu opisanego artefaktu.

attributeResources[]

string

Tylko dane wyjściowe. Nazwy wszystkich zasobów, które można wybrać przy użyciu opisanego artefaktu. Pola z tych zasobów nie dzielą danych na segmenty, gdy występują w zapytaniach.

To pole jest ustawiane tylko dla artefaktów, których kategoria to RESOURCE.

metrics[]

string

Tylko dane wyjściowe. To pole zawiera nazwy wszystkich wskaźników, które można wybrać z opisanym artefaktem, gdy jest ono używane w klauzuli FROM. Jest ustawiana tylko dla artefaktów, których kategoria to RESOURCE.

segments[]

string

Tylko dane wyjściowe. To pole zawiera nazwy wszystkich artefaktów (segmentów czy innych zasobów), które dzielą dane na segmenty, gdy są uwzględnione w zapytaniach i kiedy dany artefakt jest używany w klauzuli FROM. Jest ustawiana tylko dla artefaktów, których kategoria to RESOURCE.

enumValues[]

string

Tylko dane wyjściowe. Wartości, które może przyjąć artefakt, jeśli jest to pole typu ENUM.

To pole jest ustawione tylko dla artefaktów kategorii SEGMENT lub ATTRIBUTE.

dataType

enum (GoogleAdsFieldDataType)

Tylko dane wyjściowe. To pole określa operatory, których można używać z artefaktem w klauzulach WHERE.

name

string

Tylko dane wyjściowe. Nazwa artefaktu.

selectable

boolean

Tylko dane wyjściowe. Określa, czy artefakt może być używany w klauzuli SELECT w zapytaniach.

filterable

boolean

Tylko dane wyjściowe. Określa, czy artefakt może być używany w klauzuli WHERE w zapytaniach.

sortable

boolean

Tylko dane wyjściowe. Określa, czy artefakt może być używany w klauzuli ORDER BY w zapytaniach.

typeUrl

string

Tylko dane wyjściowe. Adres URL protokołu opisującego typ danych artefaktu.

isRepeated

boolean

Tylko dane wyjściowe. Wskazuje, czy artefakt pola się powtarza.

GoogleAdsFieldCategory

Kategoria artefaktu.

Wartości w polu enum
UNSPECIFIED Brak informacji
UNKNOWN Brak informacji
RESOURCE Opisany artefakt jest zasobem.
ATTRIBUTE Opisany artefakt jest polem i atrybutem zasobu. Uwzględnienie w zapytaniu pola atrybutu zasobu może spowodować segmentację zapytania, jeśli zasób, do którego jest przypisany, segmentuje zasób znaleziony w klauzuli FROM.
SEGMENT Opisany artefakt jest polem i zawsze dzieli zapytania na segmenty.
METRIC Opisany artefakt to pole i dane. Nigdy nie dzieli zapytań na segmenty.

GoogleAdsFieldDataType

Oto różne typy artefaktów GoogleAdsService.

Wartości w polu enum
UNSPECIFIED Brak informacji
UNKNOWN Brak informacji
BOOLEAN

Mapy na google.protobuf.BoolValue

Dostępne operatory: =, !=

DATE

Mapuje na google.protobuf.StringValue. Można ją jednak porównywać, używając zestawu operatorów dla konkretnych dat.

Dostępne operatory: =, <, >, <=, >=, BETWEEN, DURING i IN.

DOUBLE

Mapy na google.protobuf.DoubleValue

Dostępne operatory: =, !=, <, >, IN, NOT IN

ENUM

Mapuje na wyliczenie. Konkretną definicję znajdziesz na stronie typeUrl.

Dostępne operatory: =, !=, IN, NOT IN

FLOAT

Mapy na google.protobuf.FloatValue

Dostępne operatory: =, !=, <, >, IN, NOT IN

INT32

Mapy na google.protobuf.Int32Value

Dostępne operatory: =, !=, <, >, <=, >=, BETWEEN, IN, NOT IN.

INT64

Mapy na google.protobuf.Int64Value

Dostępne operatory: =, !=, <, >, <=, >=, BETWEEN, IN, NOT IN.

MESSAGE

Mapuje na typ wiadomości bufora protokołu. Szczegółowe informacje o typie danych znajdziesz w typeUrl.

Żadne operatory nie działają z polami MESSAGE.

RESOURCE_NAME

Mapuje na google.protobuf.StringValue. Reprezentuje nazwę zasobu (unikalny identyfikator) zasobu lub jednego z jego kluczy obcych.

Żadne operatory nie działają z polami RESOURCE_NAME.

STRING

Mapuje na google.protobuf.StringValue.

Dostępne operatory: =, !=, LIKE, NOT LIKE, IN, NOT IN

UINT64

Mapy na google.protobuf.UInt64Value

Dostępne operatory: =, !=, <, >, <=, >=, BETWEEN, IN, NOT IN.

Metody

get

Zwraca tylko żądane pole.
Zwraca wszystkie pola pasujące do wyszukiwanego hasła.