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

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

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

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

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

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

अनुरोध

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