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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

Search की सेवाएं

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 देखें. साथ ही, अपनी रिपोर्ट को सेगमेंट में बांटने के बारे में ज़्यादा जानने के लिए, Segmentation लेख पढ़ें.

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

यह 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 OR FIELD की जगह, कोई संसाधन (जैसे, customer या campaign) या कोई फ़ील्ड (जैसे, campaign.id, metrics.impressions, या ad_group.id) डालें.

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

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

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