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

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

एचटीटीपी अनुरोध और जवाब का नमूना

gRPC

अनुरोध में, 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 क्लॉज़ में मौजूद संसाधन के साथ, साफ़ तौर पर जोड़ा जा सकता है.
metrics
ऐसी मेट्रिक जिन्हें FROM क्लॉज़ में मौजूद संसाधन के साथ चुना जा सकता है. सिर्फ़ उन फ़ील्ड के लिए जानकारी अपने-आप भर जाती है जिनकी category RESOURCE होती है.
segments
सेगमेंट की ऐसी कुंजियां जिन्हें FROM क्लॉज़ में मौजूद संसाधन के साथ चुना जा सकता है. इनसे क्वेरी में बताई गई मेट्रिक को सेगमेंट किया जाता है. सिर्फ़ उन फ़ील्ड के लिए जानकारी अपने-आप भर जाती है जिनकी category RESOURCE होती है.
selectableWith

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

GAQL क्वेरी बनाते समय:

  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 क्लॉज़ में मौजूद अन्य सभी सेगमेंट और संसाधन शामिल होने चाहिए.

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

GoogleAdsFieldService का इस्तेमाल करके, इन लेवल पर कैटलॉग का अनुरोध किया जा सकता है:

संसाधन
उदाहरण के लिए, googleAdsFields/campaign.
संसाधन का फ़ील्ड
उदाहरण के लिए, googleAdsFields/campaign.name.
सेगमेंटेशन फ़ील्ड
उदाहरण के लिए, googleAdsFields/segments.ad_network_type.
मेट्रिक
उदाहरण के लिए, googleAdsFields/metrics.clicks.
पीछे जाएं
ऑब्जेक्ट वापस लाए जा रहे हैं
आगे बढ़ें
कॉल स्ट्रक्चर