Search Ads 360 Reporting API का नया वर्शन अब उपलब्ध है. आने वाले समय में किए जाने वाले बदलावों और रिलीज़ के बारे में अप-टू-डेट रहने के लिए, searchads-api-announcements Google ग्रुप में शामिल हों.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

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

संसाधन या फ़ील्ड को संसाधन (जैसे कि customer या campaign) या किसी फ़ील्ड (जैसे कि campaign.id, metrics.impressions या ad_group.id) से बदलें.

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

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

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