संसाधन का मेटाडेटा

GoogleAdsFieldService का इस्तेमाल करके, GoogleAdsService Search और SearchStream तरीकों में उपलब्ध संसाधनों, संसाधन के फ़ील्ड, सेगमेंटेशन की कुंजियों, और मेट्रिक के लिए कैटलॉग का डाइनैमिक तौर पर अनुरोध किया जा सकता है. कैटलॉग, मेटाडेटा उपलब्ध कराता है. इसका इस्तेमाल, Google Ads क्वेरी लैंग्वेज स्टेटमेंट की पुष्टि करने और उन्हें बनाने के लिए, Google Ads API क्लाइंट कर सकते हैं.

एचटीटीपी अनुरोध और रिस्पॉन्स का सैंपल

अनुरोध में, Google Ads API सर्वर के लिए HTTP GET शामिल होता है. यह सर्वर, यहां दिए गए यूआरएल पर मौजूद होता है:

https://googleads.googleapis.com/v19/googleAdsFields/{resource_or_field}

यहां अनुरोध का एक उदाहरण दिया गया है. इसके बाद, ad_group संसाधन के लिए GoogleAdsFieldService से मिला जवाब दिया गया है:

अनुरोध

https://googleads.googleapis.com/v19/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.
पीछे जाएं
ऑब्जेक्ट वापस लाए जा रहे हैं
आगे बढ़ें
कॉल स्ट्रक्चर