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

Google Ads क्वेरी लैंग्वेज, Google Ads API से इनके लिए क्वेरी कर सकती है

संसाधन और उनसे जुड़े एट्रिब्यूट, सेगमेंट, और मेट्रिक का इस्तेमाल करके

GoogleAdsService Search या SearchStream

GoogleAdsService क्वेरी का नतीजा, GoogleAdsRow इंस्टेंस की सूची होती है. इसमें हर GoogleAdsRow, किसी संसाधन को दिखाता है. अगर किसी एट्रिब्यूट या मेट्रिक का अनुरोध किया जाता है, तो पंक्ति में वे फ़ील्ड भी शामिल होते हैं. अगर किसी सेगमेंट का अनुरोध किया जाता है, तो रिस्पॉन्स में हर सेगमेंट-रिसॉर्स टुपल के लिए एक और पंक्ति भी दिखती है.

Metadata about available fields and resources in

GoogleAdsFieldService

यह सेवा, क्वेरी वाले फ़ील्ड का एक कैटलॉग उपलब्ध कराती है. इसमें, फ़ील्ड के काम करने के तरीके और टाइप के बारे में जानकारी होती है.

GoogleAdsFieldService क्वेरी का नतीजा, GoogleAdsField इंस्टेंस की सूची होती है. हर GoogleAdsField में, अनुरोध किए गए फ़ील्ड की जानकारी होती है.

किसी संसाधन के एट्रिब्यूट के लिए क्वेरी करना

यहां कैंपेन रिसॉर्स के एट्रिब्यूट के लिए एक बुनियादी क्वेरी दी गई है. इसमें कैंपेन आईडी, नाम, और स्थिति दिखाने का तरीका बताया गया है:

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id

यह क्वेरी, कैंपेन आईडी के हिसाब से क्रम में लगाती है. नतीजे के तौर पर मिलने वाले हर GoogleAdsRow में, चुने गए फ़ील्ड (इसमें दिए गए कैंपेन का resource_name भी शामिल है) से पॉप्युलेट किया गया campaign ऑब्जेक्ट दिखेगा.

कैंपेन क्वेरी के लिए कौनसे अन्य फ़ील्ड उपलब्ध हैं, यह जानने के लिए 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, चुने गए कैंपेन एट्रिब्यूट के साथ-साथ, बिडिंग की चुनी गई रणनीति के एट्रिब्यूट bidding_strategy.name से भरे हुए campaign ऑब्जेक्ट को दिखाता है.

कैंपेन क्वेरी के लिए, एट्रिब्यूट किए गए कौनसे संसाधन उपलब्ध हैं, यह जानने के लिए 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) से बदला जा सकता है.

अहम जानकारी: ध्यान दें कि इस क्वेरी में कोई FROM क्लॉज़ नहीं है.

क्वेरी किए जा सकने वाले फ़ील्ड की सूची के लिए, GoogleAdsField दस्तावेज़ देखें.

कोड के उदाहरण

क्लाइंट लाइब्रेरी में, GoogleAdsService में Google Ads क्वेरी भाषा का इस्तेमाल करने के उदाहरण दिए गए हैं. बुनियादी कार्रवाइयां फ़ोल्डर में, GetCampaigns, GetKeywords, और SearchForGoogleAdsFields जैसे उदाहरण हैं.