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

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.
पीछे जाएं
ऑब्जेक्ट वापस लाए जा रहे हैं
आगे बढ़ें
कॉल स्ट्रक्चर