REST Resource: googleAdsFields

Zasób: GoogleAdsField

Pole lub zasób (artefakt) używane przez 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ć za pomocą opisanego artefaktu.

attributeResources[]

string

Tylko dane wyjściowe. Nazwy wszystkich zasobów, które można wybrać z opisanym artefaktem. Pola z tych zasobów nie dzielą danych na segmenty podczas wyszukiwania w wynikach wyszukiwania.

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 on używany w klauzuli FROM. Jest ustawiany tylko dla artefaktów, których kategoria to RESOURCE.

segments[]

string

Tylko dane wyjściowe. To pole zawiera nazwy wszystkich artefaktów (segmentów lub innych zasobów), które segmentują dane po zastosowaniu w zapytaniach i o tym, kiedy dany artefakt jest używany w klauzuli FROM. Jest ustawiany 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ący 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 jest atrybutem zasobu. Umieszczenie w zapytaniu pola atrybutu zasobu może posegmentować zapytanie, jeśli zasób, do którego jest przypisane, segmentuje zasób znaleziony w klauzuli FROM.
SEGMENT Opisany artefakt jest polem i zawsze dzieli zapytania na segmenty.
METRIC Opisany artefakt jest polem i danymi. Nigdy nie dzielimy 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

Odpowiednie operatory: =, !=

DATE

Mapuje na google.protobuf.StringValue. Można go jednak porównać za pomocą zestawu operatorów specyficznych dla dat.

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

DOUBLE

Mapuje na google.protobuf.DoubleValue

Odpowiednie operatory: =, !=, <, >, IN, NOT IN

ENUM

Mapuje na wyliczenie. Jego dokładną definicję znajdziesz na stronie typeUrl.

Odpowiednie operatory: =, !=, IN, NOT IN

FLOAT

Mapuje na google.protobuf.FloatValue

Odpowiednie operatory: =, !=, <, >, IN, NOT IN

INT32

Mapuje na google.protobuf.Int32Value

Odpowiednie operatory: =, !=, <, >, <=, >=, BETWEEN, IN, NOT IN.

INT64

Mapuje na google.protobuf.Int64Value

Odpowiednie operatory: =, !=, <, >, <=, >=, BETWEEN, IN, NOT IN.

MESSAGE

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

Żadne operatory nie obsługują pól 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.

Odpowiednie operatory: =, !=, LIKE, NOT LIKE, IN, NOT IN

UINT64

Mapuje na google.protobuf.UInt64Value

Odpowiednie operatory: =, !=, <, >, <=, >=, BETWEEN, IN, NOT IN.

Metody

get

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