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.id
को और हमad_group
केsegments.date
एट्रिब्यूट को शामिल करना चाहते हैंcampaign
, हमें यह जांचना होगा किsegments.date
,selectableWith
में है या नहीं एट्रिब्यूट की वैल्यू डालें, क्योंकि इसे मौजूदा कैंपेन के बगल में चुना जा रहा हैsegments.date
फ़ील्ड.
मेटाडेटा की जानकारी
GoogleAdsFieldService
का इस्तेमाल करके, इन लेवल पर कैटलॉग का अनुरोध किया जा सकता है:
- संसाधन
- उदाहरण के लिए,
googleAdsFields/campaign
. - संसाधन का फ़ील्ड
- उदाहरण के लिए,
googleAdsFields/campaign.name
. - सेगमेंटेशन फ़ील्ड
- उदाहरण के लिए,
googleAdsFields/segments.ad_network_type
. - मेट्रिक
- उदाहरण के लिए,
googleAdsFields/metrics.clicks
.