GoogleAdsFieldService
का इस्तेमाल करके, GoogleAdsService
Search, और SearchStream के तरीकों में उपलब्ध संसाधनों, संसाधनों के फ़ील्ड, सेगमेंटेशन कुंजियों, और मेट्रिक के लिए, कैटलॉग का डाइनैमिक तरीके से अनुरोध किया जा सकता है. कैटलॉग में ऐसा मेटाडेटा मौजूद होता है जिसका इस्तेमाल Google Ads API क्लाइंट, Google Ads की क्वेरी लैंग्वेज स्टेटमेंट की पुष्टि करने और उसे तैयार करने के लिए कर सकते हैं.
एचटीटीपी अनुरोध और रिस्पॉन्स का सैंपल
अनुरोध में, Google Ads API सर्वर को इस यूआरएल पर एक HTTP GET
शामिल किया गया है:
https://googleads.googleapis.com/v17/googleAdsFields/{resource_or_field}
नीचे एक अनुरोध के बाद ad_group संसाधन के लिए
GoogleAdsFieldService
से मिले रिस्पॉन्स का एक उदाहरण दिया गया है:
अनुरोध
https://googleads.googleapis.com/v17/googleAdsFields/ad_group
जवाब
{
"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",
...
]
}
इस उदाहरण के लिए, ज़रूरी कैटगरी ये हैं:
attributeResources
- ऐसे संसाधन जिन्हें
FROM
क्लॉज़ में, संसाधन के साथ सीधे तौर पर जोड़ा जा सकता है. metrics
- ऐसी मेट्रिक जो
FROM
क्लॉज़ में संसाधन के साथ चुने जाने के लिए उपलब्ध हैं. सिर्फ़ उन फ़ील्ड के लिए जानकारी अपने-आप भर जाती है जिनमेंcategory
,RESOURCE
है. segments
- ऐसे सेगमेंट कुंजियां जिन्हें
FROM
क्लॉज़ में संसाधन के साथ चुना जा सकता है. ये क्वेरी में बताई गई मेट्रिक को सेगमेंट करते हैं. सिर्फ़ उन फ़ील्ड के लिए जानकारी अपने-आप भर जाती है जिनमेंcategory
,RESOURCE
है. selectableWith
-
- ऐसे फ़ील्ड जिन्हें दिए गए फ़ील्ड के साथ चुना जा सकता है, जब ये
FROM
क्लॉज़ में नहीं होते. यह एट्रिब्यूट सिर्फ़ तब काम का होता है, जब किसी क्वेरी में चुने जा सकने वाले रिसॉर्स या सेगमेंट की पहचान की जाती है. ऐसा तब होता है, जब वेFROM
क्लॉज़ में मौजूद संसाधनों में शामिल नहीं होते हैं. उदाहरण के लिए, अगर हमad_group
सेad_group.id
औरsegments.date
को चुनते हैं औरcampaign
के एट्रिब्यूट शामिल करना चाहते हैं, तो हमें जांच करनी होगी कि कैंपेन के लिएsegments.date
एट्रिब्यूट कोselectableWith
एट्रिब्यूट में शामिल किया गया है या नहीं. ऐसा इसलिए, क्योंकि इसे मौजूदाsegments.date
फ़ील्ड के साथ चुना जा रहा है.
मेटाडेटा की जानकारी
GoogleAdsFieldService
का इस्तेमाल करके, इन लेवल पर कैटलॉग का अनुरोध किया जा सकता है:
- संसाधन
- उदाहरण के लिए,
googleAdsFields/campaign
. - संसाधन का फ़ील्ड
- उदाहरण के लिए,
googleAdsFields/campaign.name
. - सेगमेंटेशन फ़ील्ड
- उदाहरण के लिए,
googleAdsFields/segments.ad_network_type
. - मेट्रिक
- उदाहरण के लिए,
googleAdsFields/metrics.clicks
.