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

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

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

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

सेवाएं खोजें

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

SearchAds360Service

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

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

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

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

SearchAds360FieldService

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

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

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

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

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

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

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

यह क्वेरी, उस campaign संसाधन के एट्रिब्यूट के लिए बुनियादी क्वेरी है जो नतीजे दिखाती है अभियान ID, नाम, और स्थिति:

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 में क्वेरी बनाने के तरीके के बारे में ज़्यादा जानें: