Za pomocą GoogleAdsFieldService
możesz dynamicznie wysyłać żądania do 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órych mogą używać klienci interfejsu Google Ads API do weryfikacji i tworzenia instrukcji w języku Google Ads Query Language.
Przykładowe żądanie i odpowiedź HTTP
Żądanie składa się z HTTP GET
wysyłanego do serwera Google Ads API pod tym adresem URL:
https://googleads.googleapis.com/v17/googleAdsFields/{resource_or_field}
Poniżej znajdziesz przykład żądania, po którym następuje odpowiedź zwrócona z poziomu GoogleAdsFieldService
dla zasobu ad_group:
Prośba
https://googleads.googleapis.com/v17/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 można domyślnie połączyć z zasobem w klauzuli
FROM
. metrics
- Wskaźniki, które można wybierać za pomocą zasobu w klauzuli
FROM
. Wartość jest wypełniona tylko w przypadku pól, w którychcategory
ma wartośćRESOURCE
. segments
- Segmentuj klucze, które można wybrać z zasobem w klauzuli
FROM
. Segmentują one dane określone w zapytaniu. Wartość jest podawana tylko w przypadku pól, w którychcategory
toRESOURCE
. selectableWith
-
- Pola, które można wybierać obok danego pola, jeśli nie znajduje się w klauzuli
FROM
. Ten atrybut ma znaczenie tylko przy identyfikowaniu zasobów lub segmentów, które można wybrać w zapytaniu, którego nie obejmuje zasób w klauzuliFROM
. Jeśli na przykład wybieramyad_group.id
isegments.date
zad_group
i chcemy uwzględnić atrybuty z domenycampaign
, 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 za pomocą 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
. - Wskaźnik
- Na przykład
googleAdsFields/metrics.clicks
.