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

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

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

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

https://searchads360.googleapis.com/v0/searchAds360Fields/{resource_or_field}

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

अनुरोध

https://searchads360.googleapis.com/v0/searchAds360Fields/ad_group

जवाब

{
  "resourceName": "searchAds360Fields/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
ऐसी मेट्रिक जो FROMclauज़ में रिसॉर्स के साथ चुनी जा सकती हैं. सिर्फ़ उन फ़ील्ड के लिए जानकारी अपने-आप भर जाती है जहां category RESOURCE है.
segments
सेगमेंट की ऐसी कुंजियां जिन्हें FROM क्लॉज़ में संसाधन के साथ चुना जा सकता है. ये क्वेरी में बताई गई मेट्रिक को सेगमेंट में बांटते हैं. सिर्फ़ उन फ़ील्ड के लिए जानकारी अपने-आप भर जाती है जहां category RESOURCE है.
selectableWith
ऐसे फ़ील्ड जिन्हें किसी फ़ील्ड के साथ चुना जा सकता है, जब वे FROM क्लॉज़ में न हों. यह एट्रिब्यूट सिर्फ़ तब काम आता है, जब ऐसे संसाधनों या सेगमेंट की पहचान की जा रही हो जिन्हें क्वेरी में चुना जा सकता है, लेकिन वे FROM क्लॉज़ में संसाधन के तौर पर शामिल नहीं हैं. उदाहरण के लिए, अगर ad_group से ad_group.id और segments.date चुने जा रहे हैं और आपको campaign से एट्रिब्यूट शामिल करने हैं, तो आपको यह देखना होगा कि segments.date, कैंपेन के लिए selectableWith एट्रिब्यूट में है या नहीं. ऐसा इसलिए, क्योंकि इसे मौजूदा segments.date फ़ील्ड के साथ चुना जा रहा है.

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

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

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

फ़ील्ड की जानकारी पाने के लिए क्वेरी का इस्तेमाल करना

फ़ील्ड की जानकारी पाने के लिए,

https://searchads360.googleapis.com/v0/searchAds360Fields:search

पहला उदाहरण: रेगुलर एक्सप्रेशन का इस्तेमाल करना.

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name LIKE 'ad_group.%'"

दूसरा उदाहरण: खास फ़ील्ड, मेट्रिक या सेगमेंट के बारे में क्वेरी करना.

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE
  name IN (
    "ad_group.id",
    "ad_group.name",
    "segments.date",
    "customer.id",
    "customer.manager",
    "metrics.clicks"
  )