Za pomocą GoogleAdsFieldService
możesz dynamicznie wysyłać żądania dotyczące katalogu zasobów, pól zasobów, kluczy podziału na segmenty i wskaźników dostępnych w metodach GoogleAdsService
Search i SearchStream. Katalog zawiera metadane, które mogą być wykorzystywane przez klienty interfejsu Google Ads API do weryfikowania i tworzenia instrukcji Google Ads Query Language.
Przykładowe żądanie i odpowiedź HTTP
Żądanie składa się z elementu HTTP GET
do serwera interfejsu Google Ads API pod tym adresem URL:
https://googleads.googleapis.com/v16/googleAdsFields/{resource_or_field}
Poniżej znajdziesz przykład żądania, po którym następuje odpowiedź zwrócona przez funkcję GoogleAdsFieldService
dla zasobu ad_group:
Prośba
https://googleads.googleapis.com/v16/googleAdsFields/ad_group
Odpowiedź
{
"resourceName": "googleAdsFields/ad_group",
"name": "ad_group",
"category": "RESOURCE",
"selectable": false,
"filterable": false,
"sortable": false,
"selectableWith": [
"campaign",
"customer",
"metrics.average_cpc",
"segments.device",
...
],
"attributeResources": [
"customer",
"campaign"
],
"metrics": [
"metrics.conversions",
"metrics.search_budget_lost_impression_share",
"metrics.average_cost",
"metrics.clicks",
...
],
"segments": [
"segments.date",
"segments.ad_network_type",
"segments.device",
...
]
}
W tym przykładzie ważne tablice to:
attributeResources
- Zasoby, które mogą być niejawnie połączone z zasobem w klauzuli
FROM
. metrics
- Wskaźniki, które można wybrać z zasobem w klauzuli
FROM
. Wypełniane tylko w przypadku pól, w którychcategory
toRESOURCE
. segments
- Segmentuj klucze, które można wybrać z zasobem w klauzuli
FROM
. Segmentują one dane określone w zapytaniu. Wartość jest wypełniana tylko w przypadku pól, w którychcategory
toRESOURCE
. selectableWith
-
- Pola, które można wybrać obok danego pola, gdy nie ma go w klauzuli
FROM
. Ten atrybut ma znaczenie tylko przy identyfikowaniu zasobów lub segmentów, które można wybrać w zapytaniu, jeśli nie zostały one uwzględnione przez zasób w klauzuliFROM
. Jeśli na przykład wybieramyad_group.id
isegments.date
zad_group
i chcemy uwzględnić atrybuty zcampaign
, musimy sprawdzić, czysegments.date
znajduje się w atrybucieselectableWith
kampanii, ponieważ jest on wybierany obok dotychczasowego polasegments.date
.
Szczegóły metadanych
Możesz poprosić o dostęp do katalogu, korzystając z opcji GoogleAdsFieldService
na tych poziomach:
- Zasób
- Na przykład:
googleAdsFields/campaign
. - Pole zasobu
- Na przykład:
googleAdsFields/campaign.name
. - Pole podziału na segmenty
- Na przykład:
googleAdsFields/segments.ad_network_type
. - Dane
- Na przykład:
googleAdsFields/metrics.clicks
.