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

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

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

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

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

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"
  )