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
- ऐसी मेट्रिक जो
FROM
clauज़ में रिसॉर्स के साथ चुनी जा सकती हैं. सिर्फ़ उन फ़ील्ड के लिए जानकारी अपने-आप भर जाती है जिनमें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"
)