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

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

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

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

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

नीचे एक अनुरोध के बाद ad_group संसाधन के लिए GoogleAdsFieldService से मिले रिस्पॉन्स का एक उदाहरण दिया गया है:

अनुरोध

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