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

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.id को और हम ad_group के segments.date एट्रिब्यूट को शामिल करना चाहते हैं campaign, हमें यह जांचना होगा कि segments.date, selectableWith में है या नहीं एट्रिब्यूट की वैल्यू डालें, क्योंकि इसे मौजूदा कैंपेन के बगल में चुना जा रहा है segments.date फ़ील्ड.

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

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

संसाधन
उदाहरण के लिए, googleAdsFields/campaign.
रिसॉर्स का फ़ील्ड
उदाहरण के लिए, googleAdsFields/campaign.name.
सेगमेंटेशन फ़ील्ड
उदाहरण के लिए, googleAdsFields/segments.ad_network_type.
मेट्रिक
उदाहरण के लिए, googleAdsFields/metrics.clicks.