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

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