Search Analytics: query

अनुमति की ज़रूरत है

तय किए गए फ़िल्टर और पैरामीटर की मदद से, Search Network के ट्रैफ़िक डेटा की क्वेरी करें. यह तरीका, आपकी तय की गई पंक्ति कुंजियों (डाइमेंशन) के हिसाब से ग्रुप की गई शून्य या उससे ज़्यादा पंक्तियां दिखाता है. आपको तारीख की एक या उससे ज़्यादा दिनों की सीमा तय करनी होगी.

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

नतीजों को क्लिक की संख्या के हिसाब से, घटते क्रम में क्रम से लगाया जाता है. अगर दो पंक्तियों में एक ही क्लिक की संख्या है, तो उन्हें मनचाहे तरीके से क्रम में लगाया जाता है.

इस तरीके को कॉल करने के लिए, Python सैंपल देखें.

एपीआई, Search Console की अंदरूनी सीमाओं से बंधा होता है. साथ ही, यह डेटा की सभी लाइनों को दिखाने की गारंटी नहीं देता. हालांकि, यह सबसे ऊपर की लाइनों को दिखाता है.

उपलब्ध डेटा की सीमाएं देखें.

JSON POST का उदाहरण: 
POST https://www.googleapis.com/webmasters/v3/sites/https%3A%2F%2Fwww.example.com%2F/searchAnalytics/query?key={MY_API_KEY}
{
  "startDate": "2015-04-01",
  "endDate": "2015-05-01",
  "dimensions": ["country","device"]
}
इसे अभी आज़माएं.

अनुरोध

एचटीटीपी अनुरोध

POST https://www.googleapis.com/webmasters/v3/sites/siteUrl/searchAnalytics/query

पैरामीटर

पैरामीटर का नाम मान ब्यौरा
पाथ पैरामीटर
siteUrl string Search Console में बताई गई प्रॉपर्टी का यूआरएल. उदाहरण: http://www.example.com/ (यूआरएल-प्रीफ़िक्स प्रॉपर्टी के लिए) या sc-domain:example.com (डोमेन प्रॉपर्टी के लिए)

अनुमति देना

इस अनुरोध के लिए, इनमें से कम से कम एक स्कोप के साथ अनुमति की ज़रूरत है (पुष्टि और अनुमति के बारे में ज़्यादा पढ़ें).

दायरा
https://www.googleapis.com/auth/webmasters.readonly
https://www.googleapis.com/auth/webmasters

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर के साथ डेटा उपलब्ध कराएं:

{
  "startDate": string,
  "endDate": string,
  "dimensions": [
    string
  ],
  "type": string,
  "dimensionFilterGroups": [
    {
      "groupType": string,
      "filters": [
        {
          "dimension": string,
          "operator": string,
          "expression": string
        }
      ]
    }
  ],
  "aggregationType": string,
  "rowLimit": integer,
  "startRow": integer
}
प्रॉपर्टी का नाम मान ब्यौरा नोट
startDate string [ज़रूरी है] अनुरोध की गई तारीख की सीमा की शुरुआत की तारीख, पश्चिमी समय (यूटीसी - 7:00/8:00) में, YYYY-MM-DD फ़ॉर्मैट में. खत्म होने की तारीख से कम या उसके बराबर होना चाहिए. यह वैल्यू, रेंज में शामिल होती है.
endDate string [ज़रूरी है] अनुरोध की गई तारीख की सीमा के खत्म होने की तारीख, YYYY-MM-DD फ़ॉर्मैट में, पैसिफ़िक समय (यूटीसी - 7:00/8:00) में होनी चाहिए. यह तारीख, शुरू होने की तारीख से ज़्यादा या उसके बराबर होनी चाहिए. यह वैल्यू, रेंज में शामिल होती है.
dimensions[] list [ज़रूरी नहीं] नतीजों को ग्रुप करने के लिए, शून्य या उससे ज़्यादा डाइमेंशन. नतीजों को इस क्रम में ग्रुप किया जाता है जिस क्रम में आपने ये डाइमेंशन दिए हैं. dimensionFilterGroups[].filters[].dimension में किसी भी डाइमेंशन के नाम के साथ-साथ "तारीख" का इस्तेमाल किया जा सकता है.ग्रुप के डाइमेंशन की वैल्यू को एक साथ जोड़ा जाता है, ताकि नतीजे की हर लाइन के लिए एक यूनीक कुंजी बनाई जा सके. अगर कोई डाइमेंशन नहीं दिया गया है, तो सभी वैल्यू को एक ही लाइन में जोड़ दिया जाएगा. डाइमेंशन के हिसाब से ग्रुप बनाने की कोई सीमा नहीं है. हालांकि, एक ही डाइमेंशन के हिसाब से दो बार ग्रुप नहीं बनाया जा सकता. उदाहरण: [country, device]
searchType string इस्तेमाल नहीं किया जा सकता. इसके बजाय, type का इस्तेमाल करें
type string [ज़रूरी नहीं] नतीजों को इस तरह फ़िल्टर करें:
  • "discover": 'डिस्कवर' के नतीजे
  • "googleNews": Android और iOS पर Google News ऐप्लिकेशन और news.google.com के नतीजे. इसमें Google Search के "News" टैब के नतीजे शामिल नहीं होते.
  • "news": Google Search के "खबरें" टैब से मिले खोज के नतीजे.
  • "image": Google Search में "इमेज" टैब से खोज के नतीजे.
  • "video": वीडियो के खोज नतीजे
  • "web": [डिफ़ॉल्ट] Google Search में, एक साथ दिखने वाले कई तरह के खोज नतीजों ("सभी") वाले टैब पर नतीजे फ़िल्टर करें. इसमें 'डिस्कवर' या Google News के नतीजे शामिल नहीं होते.
dimensionFilterGroups[] list [ज़रूरी नहीं] डाइमेंशन ग्रुपिंग वैल्यू पर लागू करने के लिए, फ़िल्टर के शून्य या एक से ज़्यादा ग्रुप. जवाब में कोई पंक्ति दिखाने के लिए, सभी फ़िल्टर ग्रुप मैच होने चाहिए. किसी एक फ़िल्टर ग्रुप में, यह तय किया जा सकता है कि सभी फ़िल्टर मैच होने चाहिए या कम से कम एक फ़िल्टर मैच होना चाहिए.
dimensionFilterGroups[].groupType string इस ग्रुप के सभी फ़िल्टर के लिए, सही ("और") या एक या उससे ज़्यादा फ़िल्टर के लिए, सही (अभी काम नहीं करता) दिखाना ज़रूरी है.

इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "and": फ़िल्टर ग्रुप के सही होने के लिए, ग्रुप के सभी फ़िल्टर सही होने चाहिए.
dimensionFilterGroups[].filters[] list [ज़रूरी नहीं] पंक्ति की जांच करने के लिए, शून्य या उससे ज़्यादा फ़िल्टर. हर फ़िल्टर में, डाइमेंशन का नाम, ऑपरेटर, और वैल्यू होती है. ज़्यादा से ज़्यादा 4,096 वर्ण. उदाहरण: 
country equals FRA
query contains mobile use
device notContains tablet
dimensionFilterGroups[].filters[].dimension string वह डाइमेंशन जिस पर यह फ़िल्टर लागू होता है. डेटा को यहां दिए गए किसी भी डाइमेंशन के हिसाब से फ़िल्टर किया जा सकता है. भले ही, आपने उस डाइमेंशन के हिसाब से ग्रुप न बनाए हों.

इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "country": किसी देश के हिसाब से फ़िल्टर करें. इसके लिए, देश के तीन अक्षरों वाले कोड (ISO 3166-1 alpha-3) का इस्तेमाल करें.
  • "device": डिवाइस के टाइप के हिसाब से नतीजे फ़िल्टर करें. इस्तेमाल की जा सकने वाली वैल्यू:
    • DESKTOP
    • मोबाइल
    • टैबलेट
  • "page": तय की गई यूआरआई स्ट्रिंग के हिसाब से फ़िल्टर करें.
  • "query": तय की गई क्वेरी स्ट्रिंग के हिसाब से फ़िल्टर करें.
  • "searchAppearance": खोज के नतीजे की किसी खास सुविधा के हिसाब से फ़िल्टर करें. उपलब्ध वैल्यू की सूची देखने के लिए, "searchथीम" के हिसाब से ग्रुप की गई क्वेरी चलाएं. वैल्यू और ब्यौरे की पूरी सूची, सहायता दस्तावेज़ में भी उपलब्ध है.
dimensionFilterGroups[].filters[].operator string [ज़रूरी नहीं] आपकी तय की गई वैल्यू, लाइन के डाइमेंशन की वैल्यू से कैसे मेल खानी चाहिए या नहीं खानी चाहिए.

इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "contains": लाइन की वैल्यू में आपका एक्सप्रेशन होना चाहिए या उसके बराबर होना चाहिए. यह केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) नहीं होता है.
  • "equals": [डिफ़ॉल्ट] आपका एक्सप्रेशन, लाइन की वैल्यू से पूरी तरह मेल खाना चाहिए. पेज और क्वेरी डाइमेंशन के लिए, केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होना चाहिए.
  • "notContains": लाइन की वैल्यू में, आपका एक्सप्रेशन सबस्ट्रिंग या केस-सेंसिटिव न होने वाले पूरे मैच के तौर पर नहीं होना चाहिए.
  • "notEquals": आपका एक्सप्रेशन, लाइन की वैल्यू (पेज और क्वेरी डाइमेंशन के लिए केस-सेंसिटिव) के बराबर नहीं होना चाहिए.
  • "includingRegex": ऐसा RE2 सिंटैक्स रेगुलर एक्सप्रेशन जिसका मैच होना ज़रूरी है.
  • "excludingRegex": ऐसा RE2 सिंटैक्स रेगुलर एक्सप्रेशन, जो मैच नहीं करना चाहिए.
dimensionFilterGroups[].filters[].expression string ऑपरेटर के आधार पर, फ़िल्टर से मैच करने या बाहर रखने के लिए वैल्यू.
aggregationType string

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

ध्यान दें: अगर पेज के हिसाब से ग्रुप किया जाता है या फ़िल्टर किया जाता है, तो प्रॉपर्टी के हिसाब से एग्रीगेट नहीं किया जा सकता.

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

ये वैल्यू डाली जा सकती हैं:
  • "auto": [डिफ़ॉल्ट] सेवा को एग्रीगेशन का सही टाइप तय करने दें.
  • "byNewsShowcasePanel": News शोकेस पैनल के हिसाब से वैल्यू इकट्ठा करें. इसका इस्तेमाल, NEWS_SHOWCASE searchAppearance फ़िल्टर और type=discover या type=googleNews के साथ किया जाना चाहिए. अगर पेज के हिसाब से ग्रुप किया जाता है, पेज के हिसाब से फ़िल्टर किया जाता है या किसी दूसरे searchAppearance के हिसाब से फ़िल्टर किया जाता है, तो डेटा को byNewsShowcasePanel के हिसाब से एग्रीगेट नहीं किया जा सकता.
  • "byPage": यूआरआई के हिसाब से वैल्यू इकट्ठा करें.
  • "byProperty": प्रॉपर्टी के हिसाब से वैल्यू एग्रीगेट करें. type=discover या type=googleNews के लिए उपलब्ध नहीं है
rowLimit integer [ज़रूरी नहीं; मान्य रेंज 1 से 25,000 है; डिफ़ॉल्ट तौर पर 1,000] लौटाई जाने वाली पंक्तियों की ज़्यादा से ज़्यादा संख्या. नतीजों को देखने के लिए, startRow ऑफ़सेट का इस्तेमाल करें.
startRow integer [ज़रूरी नहीं; डिफ़ॉल्ट 0 है] जवाब की पहली लाइन का इंडेक्स शून्य पर आधारित है. एक धनात्मक संख्या होनी चाहिए. अगर startRow, क्वेरी के नतीजों की संख्या से ज़्यादा है, तो जवाब में शून्य पंक्तियां दिखेंगी.
dataState string [ज़रूरी नहीं] अगर "सभी" (बड़े और छोटे अक्षरों में अंतर नहीं किया जाता) चुना जाता है, तो डेटा में नया डेटा शामिल होगा. अगर "फ़ाइनल" (बड़े और छोटे अक्षरों में अंतर नहीं किया जाता) या इस पैरामीटर को शामिल नहीं किया जाता है, तो दिखाए गए डेटा में सिर्फ़ फ़ाइनल डेटा शामिल होगा.

जवाब

नतीजों को अनुरोध में बताए गए डाइमेंशन के हिसाब से ग्रुप में बांटा जाता है. डाइमेंशन वैल्यू के एक ही सेट वाली सभी वैल्यू को एक ही पंक्ति में ग्रुप किया जाएगा. उदाहरण के लिए, अगर देश के डाइमेंशन के हिसाब से ग्रुप किया जाता है, तो "usa" के सभी नतीजे एक साथ ग्रुप किए जाएंगे, "mdv" के सभी नतीजे एक साथ ग्रुप किए जाएंगे वगैरह. अगर आपने देश और डिवाइस के हिसाब से ग्रुप किया है, तो "usa, tablet" के सभी नतीजे एक ग्रुप में, "usa, mobile" के सभी नतीजे एक ग्रुप में, और इसी तरह के अन्य नतीजे एक ग्रुप में दिखेंगे. क्लिक, इंप्रेशन वगैरह की गिनती करने के तरीके और उनका मतलब जानने के लिए, Search Network से जुड़े आंकड़ों की रिपोर्ट का दस्तावेज़ देखें.

नतीजों को क्लिक की संख्या के हिसाब से घटते क्रम में लगाया जाता है. हालांकि, तारीख के हिसाब से डेटा को ग्रुप में बांटा जाता है. इसमें नतीजों को तारीख के हिसाब से बढ़ते क्रम में लगाया जाता है. अगर दो पंक्तियों के बीच टाई हो जाता है, तो नतीजों को अपने हिसाब से क्रम में लगाया जा सकता है.

ज़्यादा से ज़्यादा कितनी वैल्यू दिखाई जा सकती हैं, यह जानने के लिए अनुरोध में मौजूद rowLimit प्रॉपर्टी देखें.

{
  "rows": [
    {
      "keys": [
        string
      ],
      "clicks": double,
      "impressions": double,
      "ctr": double,
      "position": double
    }
  ],
  "responseAggregationType": string
}
प्रॉपर्टी का नाम मान ब्यौरा नोट
rows[] list क्वेरी में दिए गए क्रम में, मुख्य वैल्यू के हिसाब से व्यवस्थित की गई पंक्तियों की सूची.
rows[].keys[] list उस पंक्ति के डाइमेंशन की वैल्यू की सूची, जो अनुरोध में दिए गए डाइमेंशन के हिसाब से ग्रुप की गई है. यह सूची, अनुरोध में दिए गए क्रम में होती है.
rows[].clicks double लाइन के लिए क्लिक की संख्या.
rows[].impressions double लाइन के लिए इंप्रेशन की संख्या.
rows[].ctr double लाइन के लिए क्लिक मिलने की दर (सीटीआर). वैल्यू 0 से 1.0 के बीच होनी चाहिए.
rows[].position double खोज के नतीजों में आपकी साइट की औसत रैंक.
responseAggregationType string नतीजों को कैसे इकट्ठा किया गया. साइट के हिसाब से और पेज के हिसाब से, डेटा का हिसाब अलग-अलग तरीके से कैसे लगाया जाता है, यह जानने के लिए सहायता दस्तावेज़ देखें.

इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "auto"
  • "byPage": नतीजों को पेज के हिसाब से एग्रीगेट किया गया था.
  • "byProperty": नतीजों को प्रॉपर्टी के हिसाब से एग्रीगेट किया गया था.

इसे आज़माएं!

लाइव डेटा पर इस तरीके को कॉल करने और जवाब देखने के लिए, नीचे दिए गए एपीआई एक्सप्लोरर का इस्तेमाल करें.