Google Ads Query Language, इन चीज़ों के लिए Google Ads API से क्वेरी कर सकता है
- इनका इस्तेमाल करके, संसाधन और उनसे जुड़े एट्रिब्यूट, सेगमेंट, और मेट्रिक
GoogleAdsService
खोजें या SearchStream- GoogleAdsService क्वेरी से मिला नतीजा,
GoogleAdsRow
इंस्टेंस की सूची है, जिसमें हरGoogleAdsRow
किसी संसाधन को दिखाता है. अगर किसी एट्रिब्यूट या मेट्रिक का अनुरोध किया जाता है, तो लाइन में वे फ़ील्ड भी शामिल होते हैं. अगर किसी सेगमेंट का अनुरोध किया जाता है, तो रिस्पॉन्स में हर सेगमेंट-रिसॉर्स टपल के लिए एक और लाइन भी दिखती है. - इसमें उपलब्ध फ़ील्ड और संसाधनों का मेटाडेटा
GoogleAdsFieldService
इस सेवा में, क्वेरी किए जा सकने वाले फ़ील्ड की एक सूची दी गई है. इसमें यह जानकारी दी गई है कि फ़ील्ड, उनके साथ काम करते हैं या नहीं. साथ ही, उनके टाइप के बारे में भी जानकारी दी जाती है.
GoogleAdsFieldService
क्वेरी से मिला नतीजा,GoogleAdsField
इंस्टेंस की सूची है. हरGoogleAdsField
में अनुरोध किए गए फ़ील्ड की जानकारी होती है.
किसी संसाधन के एट्रिब्यूट के बारे में क्वेरी करना
नीचे कैंपेन संसाधन की विशेषताओं के लिए एक बुनियादी क्वेरी दी गई है, जिसमें कैंपेन आईडी, नाम, और स्थिति देने का तरीका बताया गया है:
SELECT
campaign.id,
campaign.name,
campaign.status
FROM campaign
ORDER BY campaign.id
यह क्वेरी, कैंपेन आईडी के हिसाब से क्रम में लगी है. नतीजे के तौर पर मिलने वाला हर GoogleAdsRow
, एक campaign
ऑब्जेक्ट को दिखाएगा जिसमें चुने गए फ़ील्ड (उस कैंपेन के resource_name
भी शामिल हैं) से अपने-आप जानकारी भरी होगी.
यह जानने के लिए कि कैंपेन क्वेरी के लिए और कौनसे फ़ील्ड उपलब्ध हैं, Campaign
के रेफ़रंस दस्तावेज़ देखें.
मेट्रिक के लिए क्वेरी करना
किसी संसाधन के लिए चुने गए एट्रिब्यूट के साथ-साथ, उससे जुड़ी मेट्रिक के लिए भी क्वेरी की जा सकती है:
SELECT
campaign.id,
campaign.name,
campaign.status,
metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
AND metrics.impressions > 1000
ORDER BY campaign.id
यह क्वेरी सिर्फ़ उन कैंपेन के लिए फ़िल्टर करती है जिनकी स्थिति PAUSED
है और जिन्हें 1, 000 से ज़्यादा इंप्रेशन मिले हैं. ऐसा कैंपेन आईडी के हिसाब से क्रम में लगाया जाता है. नतीजे देने वाले हर GoogleAdsRow
में, चुनी गई मेट्रिक के हिसाब से metrics
फ़ील्ड में जानकारी अपने-आप भर जाएगी.
क्वेरी की जा सकने वाली मेट्रिक की सूची के लिए, Metrics
दस्तावेज़ देखें.
सेगमेंट के लिए क्वेरी करना
किसी संसाधन के चुने गए एट्रिब्यूट के साथ-साथ, उससे जुड़े सेगमेंट के लिए भी क्वेरी की जा सकती है:
SELECT
campaign.id,
campaign.name,
campaign.status,
metrics.impressions,
segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
AND metrics.impressions > 1000
AND segments.date during LAST_30_DAYS
ORDER BY campaign.id
मेट्रिक के लिए क्वेरी करने की तरह ही, यह क्वेरी सिर्फ़ उन कैंपेन के लिए फ़िल्टर करती है जिनकी स्थिति PAUSED
है और जिन्हें 1,000 से ज़्यादा इंप्रेशन मिले हैं. हालांकि, यह क्वेरी डेटा को तारीख के हिसाब से बांटती है. इससे नतीजे के तौर पर मिलने वाला हर GoogleAdsRow
, कैंपेन के टपल और तारीख Segment
को दिखाता है. ध्यान रखें कि सेगमेंट बनाने से, चुनी गई मेट्रिक को बांटा जाता है. इसके लिए, SELECT क्लॉज़ में हर सेगमेंट के हिसाब से डेटा को ग्रुप में बांटा जाता है.
क्वेरी किए जा सकने वाले सेगमेंट की सूची के लिए, Segments
दस्तावेज़ देखें.
किसी मिलते-जुलते संसाधन के एट्रिब्यूट के लिए क्वेरी करना
किसी दिए गए संसाधन की क्वेरी में, उपलब्ध होने पर उससे मिलते-जुलते दूसरे रिसॉर्स की तुलना में ऐसा किया जा सकता है. इन मिलते-जुलते रिसॉर्स को "एट्रिब्यूट किए गए रिसॉर्स" के तौर पर जाना जाता है. आप अपनी क्वेरी में किसी एट्रिब्यूट को चुनकर, एट्रिब्यूट किए गए रिसॉर्स की तुलना में सीधे शामिल हो सकते हैं.
SELECT
campaign.id,
campaign.name,
campaign.status,
bidding_strategy.name
FROM campaign
ORDER BY campaign.id
इस क्वेरी से न सिर्फ़ कैंपेन एट्रिब्यूट चुने जाते हैं, बल्कि चुने गए हर कैंपेन से मिलते-जुलते एट्रिब्यूट भी शामिल किए जाते हैं. नतीजे के तौर पर मिलने वाला हर GoogleAdsRow
, एक campaign
ऑब्जेक्ट को दिखाता है जिसमें चुने गए कैंपेन एट्रिब्यूट और चुनी गई बिडिंग रणनीति एट्रिब्यूट bidding_strategy.name
शामिल होते हैं.
यह जानने के लिए कि कैंपेन क्वेरी के लिए, एट्रिब्यूट किए गए कौनसे संसाधन उपलब्ध हैं, Campaign
के रेफ़रंस दस्तावेज़ देखें.
क्वेरी के नतीजों के आधार पर बदलाव करना
किसी दिए गए संसाधन के लिए क्वेरी करते समय, आप तुरंत उन नतीजों को ऑब्जेक्ट के रूप में ले सकते हैं और उनमें बदलाव कर सकते हैं. साथ ही, उस रिसॉर्स की सेवा में बदलाव करने के तरीके पर वापस भेज सकते हैं. नीचे एक सैंपल वर्कफ़्लो दिया गया है:
- उन सभी कैंपेन के लिए क्वेरी चलाएं जो मौजूदा समय में
PAUSED
हैं और जिनके इंप्रेशन 1,000 से ज़्यादा हैं. - रिस्पॉन्स में, हर
GoogleAdsRow
केcampaign
फ़ील्ड सेCampaign
ऑब्जेक्ट पाएं. - हर कैंपेन की स्थिति को
PAUSED
से बदलकरENABLED
करें. - बदले गए कैंपेन को अपडेट करने के लिए,
CampaignService.MutateCampaigns
को कॉल करें.
फ़ील्ड का मेटाडेटा
GoogleAdsFieldService
को भेजी गई क्वेरी, फ़ील्ड का मेटाडेटा वापस पाने के लिए होती हैं.
इस जानकारी का इस्तेमाल यह समझने के लिए किया जा सकता है कि किसी क्वेरी में फ़ील्ड का एक साथ कैसे इस्तेमाल किया जा सकता है. एपीआई से डेटा उपलब्ध होता है और यह क्वेरी की पुष्टि करने या उसे बनाने के लिए ज़रूरी मेटाडेटा उपलब्ध कराता है. इसलिए, डेवलपर को प्रोग्राम की मदद से ऐसा करने की अनुमति मिलती है. यहां मेटाडेटा के लिए एक सामान्य क्वेरी दी गई है:
SELECT
name,
category,
selectable,
filterable,
sortable,
selectable_with,
data_type,
is_repeated
WHERE name = "<INSERT_RESOURCE_OR_FIELD>"
इस क्वेरी में <INSERT_RESOURCE_OR_FIELD>
को संसाधन (जैसे कि customer
या campaign
) या फ़ील्ड (जैसे campaign.id
, metrics.impressions
या ad_group.id
) से बदला जा सकता है.
क्वेरी किए जा सकने वाले फ़ील्ड की सूची के लिए, GoogleAdsField
दस्तावेज़ देखें.
कोड के उदाहरण
क्लाइंट लाइब्रेरी में, GoogleAdsService
में Google Ads की क्वेरी लैंग्वेज
का इस्तेमाल करने के उदाहरण मौजूद हैं. बुनियादी कार्रवाइयां फ़ोल्डर में GetCampaigns
, GetKeywords
, और SearchForGoogleAdsFields
जैसे उदाहरण दिए गए हैं.
रिपोर्टिंग फ़ोल्डर में इसका एक GetKeywordStats
उदाहरण है.