GoogleAdsFieldService
का इस्तेमाल करके, GoogleAdsService
Search, और SearchStream तरीकों में उपलब्ध संसाधनों, संसाधनों के फ़ील्ड, सेगमेंटेशन कुंजियों, और मेट्रिक के लिए, कैटलॉग का डाइनैमिक तौर पर अनुरोध करें. इस कैटलॉग में ऐसा मेटाडेटा दिया गया है जिसका इस्तेमाल
Google Ads API क्लाइंट, Google Ads क्वेरी लैंग्वेज स्टेटमेंट की पुष्टि और उन्हें बनाने के लिए कर सकते हैं.
एचटीटीपी अनुरोध और रिस्पॉन्स का उदाहरण
इस अनुरोध में, Google Ads API सर्वर के लिए HTTP GET
को शामिल किया जाता है. यह सर्वर इस यूआरएल पर मौजूद होता है:
https://googleads.googleapis.com/v16/googleAdsFields/{resource_or_field}
नीचे एक अनुरोध का उदाहरण दिया गया है, जिसके बाद ad_group संसाधन के लिए GoogleAdsFieldService
से मिला जवाब मिला:
अनुरोध
https://googleads.googleapis.com/v16/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
.