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

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

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

ऐक्सेस पाना

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

समीक्षाएं पाना

Reply to Reviews API का इस्तेमाल करते समय, हाल ही में आई आपके ऐप्लिकेशन की समीक्षाएं शामिल होती हैं या आप कोई व्यक्तिगत समीक्षा देख सकते हैं.

समीक्षाएं का सेट वापस पाना

अपने ऐप्लिकेशन की समीक्षाओं की सूची का अनुरोध करने के लिए, 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 दिए गए परिणाम में नहीं दिखाई देते.

टिप्पणियां

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

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

starRating

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

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

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

ध्यान दें: सिर्फ़ उपयोगकर्ताओं की बनाई समीक्षाएं फिर से हासिल की जा सकती हैं या पिछले हफ़्ते में बदलाव किया गया हो. अगर आपको अपनी इस ऐप शुरुआत से है, आप डाउनलोड करने के लिए अपनी समीक्षाओं को 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!"
}

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

आपका अनुरोध पूरा होने पर, आपको रिस्पॉन्स के तौर पर यह 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 हर दिन

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