পর্যালোচনার উত্তর দিন

Google Play Developer Reply to Reviews API আপনাকে আপনার অ্যাপের জন্য ব্যবহারকারীর প্রতিক্রিয়া দেখতে এবং এই প্রতিক্রিয়াটির উত্তর দিতে দেয়৷ আপনি এই API ব্যবহার করে সরাসরি আপনার বিদ্যমান গ্রাহক সহায়তা টুলকিটের মধ্যে ব্যবহারকারীদের সাথে যোগাযোগ করতে পারেন, যেমন একটি CRM সিস্টেম।

Reply to Reviews API আপনাকে শুধুমাত্র আপনার অ্যাপের প্রোডাকশন সংস্করণের জন্য প্রতিক্রিয়া অ্যাক্সেস করতে দেয়। আপনি যদি আপনার অ্যাপ্লিকেশানের আলফা বা বিটা সংস্করণে প্রতিক্রিয়া দেখতে চান তবে পরিবর্তে Google Play Console ব্যবহার করুন৷ এছাড়াও, মনে রাখবেন যে API শুধুমাত্র মন্তব্যগুলি অন্তর্ভুক্ত করে এমন পর্যালোচনাগুলি দেখায়৷ যদি কোনো ব্যবহারকারী আপনার অ্যাপকে রেট দেয় কিন্তু কোনো মন্তব্য না দেয়, তাহলে তাদের প্রতিক্রিয়া API থেকে অ্যাক্সেসযোগ্য নয়।

অ্যাক্সেস লাভ

Reply to Reviews API এর সাথে কাজ করতে, আপনি একটি OAuth ক্লায়েন্ট বা একটি পরিষেবা অ্যাকাউন্ট ব্যবহার করে অনুমোদন প্রদান করেন। আপনি যদি একটি পরিষেবা অ্যাকাউন্ট ব্যবহার করেন তবে এই অ্যাকাউন্টের মধ্যে "পর্যালোচনার উত্তর দিন" অনুমতি সক্ষম করুন৷ এই API-তে অনুমোদিত অ্যাক্সেস স্থাপন সম্পর্কে আরও তথ্যের জন্য, API অ্যাক্সেস ক্লায়েন্ট সেট আপ করা দেখুন।

পর্যালোচনা পুনরুদ্ধার করা হচ্ছে

Reply to Reviews API ব্যবহার করার সময়, আপনি আপনার অ্যাপের জন্য সাম্প্রতিক সব পর্যালোচনার একটি তালিকা পুনরুদ্ধার করতে পারেন, অথবা আপনি একটি পৃথক পর্যালোচনা দেখতে পারেন।

পর্যালোচনার একটি সেট পুনরুদ্ধার করা হচ্ছে

আপনার অ্যাপের জন্য পর্যালোচনার একটি তালিকা অনুরোধ করতে GET পদ্ধতি ব্যবহার করুন। আপনার অনুরোধে, আপনার অ্যাপের জন্য সম্পূর্ণ-যোগ্য প্যাকেজের নাম অন্তর্ভুক্ত করুন—যেমন com.google.android.apps.maps —এবং API-এ অ্যাক্সেস পাওয়ার সময় আপনি যে অনুমোদন টোকেনটি পেয়েছেন।

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"
  }
}

প্রতিটি ফলাফল নিম্নলিখিত মেটাডেটা অন্তর্ভুক্ত:

পর্যালোচনা আইডি
এই পর্যালোচনাটিকে অনন্যভাবে চিহ্নিত করে। এটি একটি নির্দিষ্ট ব্যবহারকারীর পর্যালোচনাকেও নির্দেশ করে, যেহেতু ব্যবহারকারীরা একটি নির্দিষ্ট অ্যাপের জন্য শুধুমাত্র একটি পর্যালোচনা লিখতে পারেন।
লেখকের নাম

রিভিউ লেখেন এমন ব্যবহারকারীর নাম।

দ্রষ্টব্য: বিরল ক্ষেত্রে, authorName একটি প্রদত্ত ফলাফলে উপস্থিত নাও হতে পারে।

মন্তব্য

একটি তালিকা যা অ্যাপে ব্যবহারকারীর প্রতিক্রিয়া অন্তর্ভুক্ত করে। যদি এই পর্যালোচনাতে একটি শিরোনাম থাকে, তাহলে এই শিরোনাম এবং পর্যালোচনার মূল পাঠ উভয়ই text উপাদানে উপস্থিত হয় এবং একটি ট্যাব অক্ষর শিরোনাম এবং মূল পাঠকে আলাদা করে। lastModified উপাদানটি নির্দেশ করে যে সময়ে ব্যবহারকারী তাদের পর্যালোচনা জমা দিয়েছেন।

যদি আপনি ইতিমধ্যে এই পর্যালোচনার প্রতিক্রিয়া জানিয়ে থাকেন, তাহলে আপনার প্রতিক্রিয়া মন্তব্যের তালিকায় দ্বিতীয় উপাদান হিসেবে উপস্থিত হবে।

তারকা রেটিং

1 থেকে 5 স্কেলে আপনার অ্যাপের ব্যবহারকারীর মূল্যায়ন। 5 স্কোর নির্দেশ করে যে ব্যবহারকারী আপনার অ্যাপের সাথে অত্যন্ত সন্তুষ্ট।

ডিফল্টরূপে, প্রতিটি পৃষ্ঠায় 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 পদ্ধতি ব্যবহার করতে পারেন। আপনি পর্যালোচনার একটি সেট পুনরুদ্ধারের জন্য ব্যবহৃত URLটির মতো একই ইউআরএল প্রদান করেন, আপনি যে পর্যালোচনাটি দেখতে চান তার সাথে সংশ্লিষ্ট 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
      }
    }
  ]
}

পর্যালোচনা পাঠ্য অনুবাদ করা হচ্ছে

পর্যালোচনা API থেকে ফিরে আসার আগে পর্যালোচনা পাঠ্য স্বয়ংক্রিয়ভাবে অনুবাদ করা যেতে পারে। পর্যালোচনার একটি তালিকা বা একটি একক পর্যালোচনা পুনরুদ্ধার করার সময়, ক্যোয়ারীতে একটি 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টি অক্ষর থাকতে পারে৷ আপনার উত্তরে প্লেইন টেক্সট ব্যবহার করা উচিত; সুগঠিত HTML ট্যাগগুলি সরানো হয় এবং আপনার উত্তরের জন্য অক্ষর গণনায় অন্তর্ভুক্ত করা হয় না। যদিও আপনি সুগঠিত HTML ট্যাগের ভিতরে যে বিষয়বস্তু রাখেন তা সংরক্ষিত থাকে।

আপনার অনুরোধ সফল হলে, আপনি প্রতিক্রিয়া হিসাবে নিম্নলিখিত JSON স্ট্রিং পাবেন। lastEdited উপাদানটি নির্দেশ করে যে সময়ে API ব্যবহারকারীর পর্যালোচনাতে আপনার উত্তর রেকর্ড করে।

{
  "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 অনুরোধ (পর্যালোচনার উত্তর দেওয়ার জন্য) – প্রতিদিন 2000

যদি আপনার অ্যাপটিকে এই কোটাগুলির চেয়ে বেশি পরিমাণের পর্যালোচনা পুনরুদ্ধার বা উত্তর দিতে হয়, তাহলে আপনার অ্যাপের কোটা বাড়ানোর জন্য একটি অনুরোধ পাঠান