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

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

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

कोड के उदाहरण

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