समीक्षाओं के जवाब देना

Google Play Developer Reply to Reviews API की मदद से, अपने ऐप्लिकेशन के बारे में उपयोगकर्ताओं के सुझाव देखे जा सकते हैं. साथ ही, इस सुझाव का जवाब भी दिया जा सकता है. इस एपीआई का इस्तेमाल करके, सीआरएम सिस्टम जैसे अपने मौजूदा ग्राहक सहायता टूलकिट में उपयोगकर्ताओं से सीधे बातचीत की जा सकती है.

Reply to Reviews API की मदद से, आपको अपने ऐप्लिकेशन के सिर्फ़ प्रोडक्शन वर्शन के लिए सुझाव, शिकायत या राय ऐक्सेस करने की सुविधा मिलती है. अगर आपको अपने ऐप्लिकेशन के ऐल्फ़ा या बीटा वर्शन के बारे में राय चाहिए, तो Google Play Console का इस्तेमाल करें. साथ ही, ध्यान रखें कि यह एपीआई सिर्फ़ वे समीक्षाएं दिखाता है जिनमें टिप्पणियां शामिल होती हैं. अगर कोई उपयोगकर्ता आपके ऐप्लिकेशन को रेटिंग देता है, लेकिन वह कोई टिप्पणी नहीं करता, तो उसके सुझाव, शिकायत या राय को एपीआई ऐक्सेस नहीं कर सकता.

ऐक्सेस पाना

Reply to Reviews API के साथ काम करने के लिए, OAuth क्लाइंट या सेवा खाते का इस्तेमाल करके अनुमति दी जाती है. अगर किसी सेवा खाते का इस्तेमाल किया जा रहा है, तो इस खाते में "समीक्षाओं का जवाब दें" अनुमति को चालू करें. इस एपीआई का आधिकारिक ऐक्सेस सेट अप करने के बारे में ज़्यादा जानने के लिए, एपीआई ऐक्सेस क्लाइंट सेट अप करना लेख पढ़ें.

समीक्षाएं फ़ेच की जा रही हैं

समीक्षाओं का जवाब दें एपीआई का इस्तेमाल करते समय, आप अपने ऐप्लिकेशन के लिए हाल ही में की गई सभी समीक्षाओं की एक सूची पा सकते हैं या कोई एक समीक्षा देख सकते हैं.

समीक्षाओं का सेट फ़ेच किया जा रहा है

अपने ऐप्लिकेशन की समीक्षाओं की सूची का अनुरोध करने के लिए, GET का इस्तेमाल करें. अपने अनुरोध में, ऐप्लिकेशन के पैकेज का वह नाम बताएं जो सभी शर्तें पूरी करता हो. जैसे, com.google.android.apps.maps—और एपीआई का ऐक्सेस पाने के लिए मिला ऑथराइज़ेशन टोकन.

GET https://www.googleapis.com/androidpublisher/v3/applications/your_package_name/reviews?
access_token=your_auth_token

रिस्पॉन्स एक JSON स्ट्रिंग है, जिसमें आपके ऐप्लिकेशन की समीक्षाओं की सूची होती है. सूची के पहले नतीजे में उपयोगकर्ता की वह टिप्पणी दिखती है जो हाल ही में बनाई गई थी या जिसमें बदलाव किया गया था.

नीचे दिए गए उदाहरण में, पहली समीक्षा में सभी नतीजों में दिखने वाला मेटाडेटा दिखाया गया है और दूसरी समीक्षा में ऐसा मेटाडेटा दिखाया गया है जो सिर्फ़ कुछ नतीजों में दिखता है:

{
  "reviews": [
    {
      "reviewId": "12345678",
      "authorName": "Jane Bloggs",
      "comments": [
        {
          "userComment": {
            "text": "This is the best app ever!",
            "lastModified": {
              "seconds": "1443676826",
              "nanos": 713000000
            },
            "starRating": 5
          }
        }
      ]
    },
    {
      "reviewId": "11223344",
      "authorName": "John Doe",
      "comments": [
        {
          "userComment": {
            "text": "I love using this app!",
            "lastModified": {
              "seconds": "141582134",
              "nanos": 213000000
            },
            "starRating": 5,
            "reviewerLanguage": "en",
            "device": "trltecan",
            "androidOsVersion": 21,
            "appVersionCode": 12345,
            "appVersionName": "1.2.3",
            "thumbsUpCount": 10,
            "thumbsDownCount": 3,
            "deviceMetadata": {
              "productName": "E5333 (Xperia™ C4 Dual)",
              "manufacturer": "Sony",
              "deviceClass": "phone",
              "screenWidthPx": 1080,
              "screenHeightPx": 1920,
              "nativePlatform": "armeabi-v7a,armeabi,arm64-v8a",
              "screenDensityDpi": 480,
              "glEsVersion": 196608,
              "cpuModel": "MT6752",
              "cpuMake": "Mediatek",
              "ramMb": 2048
            }
          }
        },
        {
          "developerComment": {
            "text": "That's great to hear!",
            "lastModified": {
              "seconds": "1423101467",
              "nanos": 813000000
            }
          }
        }
      ]
    }
  ],
  "tokenPagination": {
    "nextPageToken": "12334566"
  }
}

हर नतीजे में यह मेटाडेटा शामिल होता है:

reviewId

इस समीक्षा की खास तौर पर पहचान करता है. यह किसी उपयोगकर्ता की खास समीक्षा को भी दिखाता है, क्योंकि उपयोगकर्ता किसी खास ऐप्लिकेशन के लिए सिर्फ़ एक समीक्षा लिख सकते हैं.

authorName

समीक्षा लिखने वाले उपयोगकर्ता का नाम.

ध्यान दें: बहुत कम मामलों में ऐसा हो सकता है कि authorName, दिए गए नतीजे में न दिखे.

comments

वह सूची जिसमें ऐप्लिकेशन के बारे में लोगों के सुझाव, शिकायत या राय शामिल होती है. अगर इस समीक्षा में कोई टाइटल शामिल है, तो यह शीर्षक और समीक्षा का मुख्य टेक्स्ट, दोनों text एलिमेंट में दिखते हैं. साथ ही, एक टैब वर्ण, टाइटल और मुख्य हिस्से को अलग करता है. lastModified एलिमेंट से पता चलता है कि उपयोगकर्ता ने हाल ही में अपनी समीक्षा कब सबमिट की थी.

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

starRating

एक से पांच के स्केल पर आपके ऐप्लिकेशन का उपयोगकर्ता का आकलन. पांच का स्कोर बताता है कि उपयोगकर्ता आपके ऐप्लिकेशन से बहुत ज़्यादा संतुष्ट है.

डिफ़ॉल्ट रूप से, हर पेज पर 10 समीक्षाएं दिखती हैं. अपने अनुरोध में maxResults पैरामीटर सेट करके, हर पेज पर ज़्यादा से ज़्यादा 100 समीक्षाएं दिखाई जा सकती हैं.

अगर समीक्षाओं की सूची किसी दूसरे पेज पर भी दिखती है, तो एपीआई, रिस्पॉन्स में tokenPagination एलिमेंट शामिल करता है. समीक्षाओं के अगले पेज के लिए अनुरोध करते समय, token एलिमेंट शामिल करें. इस एलिमेंट की वैल्यू को nextPageToken वैल्यू पर सेट करें, जो ओरिजनल रिस्पॉन्स में दिखता है.

ध्यान दें: सिर्फ़ उन समीक्षाओं को वापस लाया जा सकता है जिन्हें उपयोगकर्ताओं ने पिछले एक हफ़्ते में बनाया है या उनमें बदलाव किया है. अगर आपको शुरुआत से ही अपने ऐप्लिकेशन की सभी समीक्षाएं वापस लानी हैं, तो Google Play Console का इस्तेमाल करके, अपनी समीक्षाएं CSV फ़ाइल के तौर पर डाउनलोड की जा सकती हैं.

GET अनुरोध के इस उदाहरण में, समीक्षाओं का अगला पेज दिखाया गया है. इस अनुरोध में यह माना जाता है कि समीक्षाओं के मौजूदा पेज (जैसा कि पिछले अनुरोध के जवाब में दिखाया गया है) में "12334566" की nextPageToken वैल्यू शामिल है. अनुरोध में यह भी बताया गया है कि अगले पेज पर ज़्यादा से ज़्यादा 50 समीक्षाएं दिखनी चाहिए.

GET https://www.googleapis.com/androidpublisher/v3/applications/your_package_name/reviews?
access_token=your_auth_token&token=12334566&maxResults=50

किसी व्यक्तिगत समीक्षा को वापस लाना

किसी व्यक्तिगत समीक्षा को फिर से पाने के लिए, GET तरीके का इस्तेमाल भी किया जा सकता है. आपको वही यूआरएल देना होगा जिसका इस्तेमाल समीक्षाओं का सेट वापस पाने के लिए किया गया था. हालांकि, आपको जिस समीक्षा को देखना है उससे जुड़ा review_id भी शामिल करना होगा:

GET https://www.googleapis.com/androidpublisher/v3/applications/your_package_name/reviews/
review_id?access_token=your_auth_token

संबंधित जवाब एक JSON स्ट्रिंग है, जिसमें एक ही समीक्षा के लिए कॉन्टेंट और मेटाडेटा शामिल है:

{
  "reviewId": "87654321",
  "authorName": "Joan Smith",
  "comments": [
    {
      "userComment": {
        "text": "This app is awesome!",
        "lastModified": {
          "seconds": "1452114723",
          "nanos": 913000000
        },
        "starRating": 5
      }
    }
  ]
}

समीक्षा के टेक्स्ट का अनुवाद किया जा रहा है

समीक्षाओं वाले एपीआई से दिखाए जाने से पहले, समीक्षा के टेक्स्ट का अपने-आप अनुवाद हो सकता है. समीक्षाओं की सूची या सिर्फ़ एक समीक्षा लोड करते समय, क्वेरी में translationLanguage पैरामीटर जोड़ें. उदाहरण के लिए:

GET https://www.googleapis.com/androidpublisher/v3/applications/your_package_name/reviews?
access_token=your_auth_token&translationLanguage=en

translationLanguage पैरामीटर में, देश के साथ या उसके बिना भाषा की जानकारी दी जा सकती है. उदाहरण के लिए, "en" और "en_GB", दोनों मान्य हैं.

अगर अनुवाद के लिए ऐसी भाषा तय की जाती है जो मूल टेक्स्ट से अलग है, तो सिस्टम text प्रॉपर्टी में अनुवाद किया गया टेक्स्ट और originalText प्रॉपर्टी में ओरिजनल टेक्स्ट दिखाता है. यहां एक उदाहरण दिया गया है:

    {
      "reviewId": "12345678",
      "authorName": "Jane Bloggs",
      "comments": [
        {
          "userComment": {
            "text": "This is the best app ever!",
            "lastModified": {
              "seconds": "1443676826",
              "nanos": 713000000
            },
            "starRating": 5,
            "originalText": "Dies ist die beste App überhaupt!"
          }
        }
      ]
    }

समीक्षाओं का जवाब देना

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

हम समीक्षाओं के अपने-आप दिए जाने वाले जवाब इस्तेमाल करने से मना करते हैं, ताकि बाद में उन जवाबों को मैन्युअल तरीके से अपडेट किया जा सके. साथ ही, आप किसी समीक्षा का जवाब जितनी बार चाहें, उतनी बार दे सकते हैं. हालांकि, उपयोगकर्ता को सूचना तब ही मिलती है, जब पहली बार किसी समीक्षा का जवाब दिया जाता है. इस टेबल में बताया गया है कि उपयोगकर्ता के साथ आपके इंटरैक्शन के दौरान, उसे किस तरह सूचना दी जाती है:

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

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

उपयोगकर्ता की समीक्षा का जवाब सबमिट करने के लिए, POST तरीके का इस्तेमाल करें. अपने अनुरोध में बताएं कि Content-Type, application/json है और एक JSON दस्तावेज़ शामिल करें, जिसमें आपका जवाब शामिल हो:

POST https://www.googleapis.com/androidpublisher/v3/applications/your_package_name/reviews/
review_id:reply?access_token=your_access_token
Content-Type: application/json

{
  "replyText": "Thanks for your feedback!"
}

ध्यान दें: POST अनुरोध के साथ शामिल किए जाने वाले replyText में, ज़्यादा से ज़्यादा 350 वर्ण हो सकते हैं. आपको अपने जवाब में सादा टेक्स्ट इस्तेमाल करना चाहिए. अच्छी तरह से बने एचटीएमएल टैग हटा दिए जाते हैं और आपके जवाब के वर्णों में शामिल नहीं किए जाते. हालांकि, अच्छी तरह से बनाए गए एचटीएमएल टैग में आपका कॉन्टेंट सुरक्षित रखा जाता है.

अगर आपका अनुरोध पूरा हो जाता है, तो आपको जवाब के तौर पर यह JSON स्ट्रिंग मिलेगी. lastEdited एलिमेंट वह समय बताता है जब एपीआई, उपयोगकर्ता की समीक्षा के लिए आपके जवाब को रिकॉर्ड करता है.

{
  "result": {
    "replyText": "Thanks for your feedback!",
    "lastEdited": {
      "seconds": "1453978803",
      "nanos": 796000000
    }
  }
}

अगर आपका POST अनुरोध अमान्य है, तो रिस्पॉन्स, नीचे दिए गए गड़बड़ी कोड में से कोई एक दिखाता है:

400 Bad Reply Request

replyText बहुत लंबा है या मौजूद नहीं है.

404 Not Found

दी गई review_id वाली समीक्षा मौजूद नहीं है.

कोटा

अन्य डेवलपर को ध्यान में रखते हुए, Reply to Reviews API के लिए कई कोटे लागू किए गए हैं. ये कोटा हर ऐप्लिकेशन के आधार पर अलग से लागू किए जाते हैं:

• GET अनुरोध (समीक्षाओं की सूचियों और अलग-अलग समीक्षाओं की सूची फिर से पाने के लिए) – 200 प्रति घंटा

• POST अनुरोध (समीक्षाओं का जवाब देने के लिए) – 2,000 हर दिन

अगर आपके ऐप्लिकेशन को समीक्षाओं की संख्या, इन कोटे की अनुमति से ज़्यादा संख्या में पाना है या उनका जवाब देना है, तो अपने ऐप्लिकेशन का कोटा बढ़ाने के लिए अनुरोध भेजें.