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

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

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

अनुरोध में Search Ads 360 Reporting API सर्वर से जुड़ा एक HTTP GET शामिल होता है. निम्न URL:

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.id को चुना जा रहा है और ad_group के 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

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

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