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

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

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

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

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

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

अनुरोध

https://googleads.googleapis.com/v20/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

FROMclauज़ में, रिसॉर्स के साथ चुनी जा सकने वाली मेट्रिक. सिर्फ़ उन फ़ील्ड के लिए जानकारी अपने-आप भर जाती है जहां 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.