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

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

एचटीटीपी अनुरोध और जवाब का उदाहरण

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

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

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

अनुरोध

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