Google Ads क्वेरी लैंग्वेज

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 के रेफ़रंस दस्तावेज़ देखें.

क्वेरी के नतीजों के आधार पर बदलाव करना

किसी दिए गए संसाधन के लिए क्वेरी करते समय, आप तुरंत उन नतीजों को ऑब्जेक्ट के रूप में ले सकते हैं और उनमें बदलाव कर सकते हैं. साथ ही, उस रिसॉर्स की सेवा में बदलाव करने के तरीके पर वापस भेज सकते हैं. नीचे एक सैंपल वर्कफ़्लो दिया गया है:

  1. उन सभी कैंपेन के लिए क्वेरी चलाएं जो मौजूदा समय में PAUSED हैं और जिनके इंप्रेशन 1,000 से ज़्यादा हैं.
  2. रिस्पॉन्स में, हर GoogleAdsRow के campaign फ़ील्ड से Campaign ऑब्जेक्ट पाएं.
  3. हर कैंपेन की स्थिति को PAUSED से बदलकर ENABLED करें.
  4. बदले गए कैंपेन को अपडेट करने के लिए, 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 उदाहरण है.

आगे बढ़ें
क्वेरी का व्याकरण