Search Ads 360 क्वेरी की भाषा

Search Ads 360 की क्वेरी भाषा की मदद से खोज क्वेरी बनाई जा सकती हैं. इससे Search Ads 360 Reporting API का इस्तेमाल करके रिपोर्टिंग डेटा और संसाधन मेटाडेटा हासिल किया जा सकता है.

सेवाएं खोजना

Search Ads 360 क्वेरी लैंग्वेज का इस्तेमाल करके, एपीआई से क्वेरी की जा सकती है. इसके लिए, इनका इस्तेमाल किया जा सकता है:

SearchAds360Service

इस सेवा का इस्तेमाल करके, संसाधनों और उनसे जुड़े एट्रिब्यूट, सेगमेंट, और मेट्रिक के बारे में क्वेरी करें. इसके दो तरीके हैं, Search और SearchStream.

SearchAds360Service क्वेरी, SearchAds360Row के इंस्टेंस की सूची दिखाती हैं:

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

ज़्यादा जानकारी के लिए, सर्च रिपोर्ट बनाना लेख देखें.

SearchAds360FieldService

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

SearchAds360FieldService, SearchAds360Field के इंस्टेंस की सूची दिखाता है:

  • हर फ़ील्ड में, अनुरोध किए गए फ़ील्ड के बारे में जानकारी होती है.

ज़्यादा जानने के लिए, संसाधन का मेटाडेटा वापस पाना लेख पढ़ें.

बुनियादी क्वेरी के उदाहरण

नीचे दिए गए सेक्शन में, क्वेरी के बुनियादी उदाहरण दिए गए हैं. इनका इस्तेमाल करके, अपनी क्वेरी बनाई जा सकती हैं.

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

यह क्वेरी, campaign संसाधन के एट्रिब्यूट के लिए है, जो कैंपेन आईडी, नाम, और स्टेटस दिखाता है:

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id
  • लौटाए गए हर SearchAds360Row में एक campaign ऑब्जेक्ट होता है.
  • पंक्तियों में चुने गए फ़ील्ड (इसमें दिए गए कैंपेन का 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 से ज़्यादा इंप्रेशन वाले कैंपेन मिलते हैं.
  • दिखाए गए हर SearchAds360Row में, चुनी गई मेट्रिक से भरा metrics फ़ील्ड होता है.
  • कैंपेन आईडी के हिसाब से क्वेरी के ऑर्डर.

अपनी क्वेरी में इस्तेमाल की जा सकने वाली अन्य उपलब्ध मेट्रिक के लिए, metrics देखें.

सेगमेंट के लिए क्वेरी

यह campaign संसाधन के एट्रिब्यूट से जुड़े सेगमेंट के लिए बुनियादी क्वेरी है:

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 से ज़्यादा इंप्रेशन वाले कैंपेन दिखते हैं.
  • यह डेटा को तारीख के हिसाब से बांटता है.
  • सेगमेंटेशन की वजह से, हर SearchAds360Row किसी कैंपेन और तारीख के सेगमेंट के टुपल को दिखाता है.
  • कैंपेन आईडी के हिसाब से क्वेरी का क्रम.

अपनी क्वेरी में इस्तेमाल किए जा सकने वाले सेगमेंट की सूची के लिए, segments देखें. साथ ही, अपनी रिपोर्ट को सेगमेंट में बांटने के बारे में ज़्यादा जानकारी के लिए, सेगमेंटेशन देखें.

यह campaign रिसॉर्स पर एक बुनियादी क्वेरी है, जो उपलब्ध होने पर bidding_strategy रिसॉर्स के एट्रिब्यूट को जोड़ती है. इस तरह के मिलते-जुलते रिसॉर्स को एट्रिब्यूट किया गया रिसॉर्स कहा जाता है.

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id
  • क्वेरी, चुने गए हर कैंपेन से कैंपेन एट्रिब्यूट और उनसे जुड़े एट्रिब्यूट चुनती है.
  • दिखाया गया हर SearchAds360Row, एक campaign ऑब्जेक्ट के बारे में बताता है जिसमें चुने गए कैंपेन एट्रिब्यूट के साथ-साथ, बिडिंग की रणनीति का चुना गया एट्रिब्यूट bidding_strategy.name शामिल होता है.

कैंपेन क्वेरी के लिए, एट्रिब्यूट किए गए कौनसे संसाधन उपलब्ध हैं, यह जानने के लिए campaign देखें.

फ़ील्ड मेटाडेटा के लिए क्वेरी

फ़ील्ड का मेटाडेटा पाने के लिए, SearchAds360FieldService का इस्तेमाल किया जा सकता है.

फ़ील्ड मेटाडेटा के लिए यह एक बुनियादी क्वेरी है:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = RESOURCE/FIELD
  • RESOURCE या FIELD को किसी संसाधन (जैसे, customer या campaign) या फ़ील्ड (जैसे, campaign.id, metrics.impressions या ad_group.id) से बदलें.

फ़ील्ड मेटाडेटा को वापस पाने के बारे में ज़्यादा जानने के लिए, संसाधन का मेटाडेटा वापस पाना लेख पढ़ें.

ज़्यादा जानें

Search Ads 360 Reporting API में क्वेरी बनाने के तरीके के बारे में ज़्यादा जानें: