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