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

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

एचटीटीपी अनुरोध और रिस्पॉन्स का उदाहरण

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

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

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

अनुरोध

https://googleads.googleapis.com/v25/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 क्लॉज़ में मौजूद संसाधन से इंप्लिसिट तौर पर जोड़ा जा सकता है. यह सिर्फ़ उन फ़ील्ड के लिए अपने-आप भरता है जहां category RESOURCE है.

metrics

FROM क्लॉज़ में, संसाधन के साथ चुनी जा सकने वाली मेट्रिक. यह सिर्फ़ उन फ़ील्ड के लिए अपने-आप भरता है जहां category RESOURCE है.

segments

सेगमेंट कुंजियां (segments.* फ़ील्ड और सेगमेंट करने वाले संसाधन), जिन्हें FROM क्लॉज़ में संसाधन के साथ चुना जा सकता है. ये क्वेरी में बताई गई मेट्रिक को सेगमेंट करते हैं. यह सिर्फ़ उन फ़ील्ड के लिए अपने-आप भरता है जहां category RESOURCE है.

selectableWith

ऐसे संसाधन, सेगमेंट या मेट्रिक जिन्हें Google Ads क्वेरी लैंग्वेज की एक ही क्वेरी में चुना जा सकता है. ऐसा तब होता है, जब यह संसाधन या सेगमेंट FROM क्लॉज़ में मुख्य संसाधन न हो.

selectableWith के साथ काम करने की सुविधा के बारे में क्वेरी करना

किसी संसाधन या सेगमेंट फ़ील्ड पर मौजूद selectableWith एट्रिब्यूट, अन्य संसाधनों, सेगमेंट या मेट्रिक के बारे में बताता है. इन्हें एक ही Google Ads क्वेरी लैंग्वेज क्वेरी में चुना जा सकता है. अगर आपको किसी ऐसे संसाधन या सेगमेंट के फ़ील्ड शामिल करने हैं जो FROM क्लॉज़ में नहीं दिया गया है, तो यह एट्रिब्यूट बहुत ज़रूरी है.

Google Ads क्वेरी लैंग्वेज क्वेरी बनाते समय:

1. FROM क्लॉज़ में मौजूद संसाधन, मुख्य इकाई होता है. इस संसाधन से फ़ील्ड हमेशा चुने जा सकते हैं.
2. इसके अलावा, मुख्य इकाई के साथ काम करने वाली मेट्रिक और सेगमेंट भी चुने जा सकते हैं.
3. अगर आपने FROM क्लॉज़ के बाहर मौजूद किसी संसाधन या सेगमेंट से फ़ील्ड शामिल किए हैं, तो आपको यह पक्का करना होगा कि यह गैर-FROM संसाधन या सेगमेंट, क्वेरी में चुने गए अन्य सभी फ़ील्ड, सेगमेंट, और मेट्रिक के साथ काम करता हो.

किसी खास संसाधन (संसाधन A) के लिए selectableWith सूची में वे सभी अन्य संसाधन, सेगमेंट, और मेट्रिक शामिल होती हैं जिन्हें संसाधन A के फ़ील्ड के साथ चुना जा सकता है. ऐसा तब होता है, जब संसाधन A मुख्य इकाई न हो.

उदाहरण

क्वेरी का यह उदाहरण देखें:

SELECT ad_group.id, segments.date, campaign.name FROM ad_group

• FROM क्लॉज़ में ad_group की जानकारी दी जाती है.
• इस क्वेरी में ad_group.id (FROM संसाधन से), segments.date, और campaign.name को चुना गया है.
• campaign.name को चुना गया है, लेकिन campaign, FROM क्लॉज़ में नहीं है. इसलिए, आपको यह पुष्टि करनी होगी कि यह चुने गए अन्य एलिमेंट के साथ काम करता है या नहीं.
• यह पक्का करने के लिए कि यह क्वेरी मान्य है, campaign रिसोर्स को segments.date (चुना गया कोई दूसरा फ़ील्ड) के साथ काम करना चाहिए. इसलिए, आपको campaign संसाधन के लिए selectableWith एट्रिब्यूट की वैल्यू की जांच करनी होगी. अगर segments.date, campaign की selectableWith सूची में मौजूद है, तो क्वेरी मान्य है.

अगर आपने किसी ऐसी संसाधन से फ़ील्ड चुने हैं जो FROM क्लॉज़ में नहीं है, तो उस संसाधन की selectableWith सूची में, आपके SELECT क्लॉज़ में मौजूद अन्य सभी सेगमेंट और संसाधन शामिल होने चाहिए.

मेटाडेटा की जानकारी

इन GoogleAdsFieldCategory लेवल पर, GoogleAdsFieldService का इस्तेमाल करके कैटलॉग का अनुरोध किया जा सकता है. इसके लिए, GetGoogleAdsField के साथ संसाधन का नाम या SearchGoogleAdsFields के साथ क्वेरी का इस्तेमाल किया जा सकता है:

संसाधन (RESOURCE)

उदाहरण के लिए, googleAdsFields/campaign.

संसाधन एट्रिब्यूट (ATTRIBUTE)

उदाहरण के लिए, googleAdsFields/campaign.name.

सेगमेंटेशन फ़ील्ड (SEGMENT)

उदाहरण के लिए, googleAdsFields/segments.ad_network_type.

मेट्रिक (METRIC)

उदाहरण के लिए, googleAdsFields/metrics.clicks.