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

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

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

GoogleAdsService Search या SearchStream

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

इसमें उपलब्ध फ़ील्ड और संसाधनों के बारे में मेटाडेटा

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, एक 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 का एक उदाहरण है.