उदाहरण

यहां MerchantPerformanceView के लिए एक सैंपल क्वेरी दी गई है. इससे आपको पिछले 30 दिनों में अपने खाते की परफ़ॉर्मेंस के बारे में जानकारी मिलेगी. साथ ही, इसे program और offer_id के हिसाब से सेगमेंट किया गया है. Reports सेवा के बारे में जानने के लिए, यह छोटा सा उदाहरण आज़माएं.

इस रिपोर्ट को वापस पाने के लिए, आपके पास रिपोर्टिंग मैनेजर की भूमिका होनी चाहिए.

अनुरोध करने के लिए, Merchant Center Query Language के इस स्टेटमेंट को reports.search तरीके पर पास करें:

SELECT
  segments.program,
  segments.offer_id,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'

Run

API Explorer में मौजूद सैंपल को आज़माने के लिए, चलाएं पर क्लिक करें. चलाएं पर क्लिक करने के बाद, अनुरोध यूआरएल में मौजूद कारोबारी या कंपनी के आईडी वाले प्लेसहोल्डर को अपने कारोबारी या कंपनी के आईडी से अपडेट करें. क्वेरी में बदलाव किया जा सकता है. एपीआई एक्सप्लोरर के साथ काम करने के लिए, पूरी क्वेरी एक ही लाइन में होनी चाहिए.

ध्यान दें: इस गाइड में, एचटीटीपी अनुरोध को सिखाने के टूल के तौर पर दिखाया गया है. हालांकि, हम आपको सुझाव देते हैं कि अनुरोध सबमिट करने के लिए, क्लाइंट लाइब्रेरी में से किसी एक का इस्तेमाल करें.

एचटीटीपी अनुरोध का यूआरएल

अनुरोध में, Content API for Shopping सर्वर को भेजा गया एचटीटीपी पोस्ट शामिल होता है. यह अनुरोध, इस यूआरएल पर भेजा जाता है:

https://shoppingcontent.googleapis.com/content/v2.1/merchantId/reports/search

पूरे एचटीटीपी अनुरोध का सैंपल

यहां एक पूरा उदाहरण दिया गया है. इसमें ऊपर दी गई रिपोर्ट की परिभाषा को एचटीटीपी पोस्ट अनुरोध में शामिल किया गया है:

POST /v2.1/merchantId/reports/search HTTP/1.1
Host: shoppingcontent.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer access token

Parameters:
{
  "query" : "SELECT segments.program, segments.offer_id, metrics.impressions,
                    metrics.clicks, metrics.ctr
            FROM MerchantPerformanceView
            WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'"
}