ตอบกลับรีวิว

API การตอบกลับรีวิวของนักพัฒนาซอฟต์แวร์ Google Play ช่วยให้คุณสามารถดูความคิดเห็นของผู้ใช้ สำหรับแอปของคุณและตอบกลับความคิดเห็นนี้ คุณสามารถใช้ API นี้เพื่อโต้ตอบกับ ผู้ใช้โดยตรงภายในชุดเครื่องมือการสนับสนุนลูกค้าที่มีอยู่ เช่น CRM ระบบ

Reply to Reviews API ให้คุณเข้าถึงความคิดเห็นสำหรับเวอร์ชันที่ใช้งานจริงเท่านั้น เวอร์ชันแอปของคุณ ถ้าคุณต้องการดูความคิดเห็นเกี่ยวกับ เวอร์ชันอัลฟ่าหรือเบต้าของ แอปของคุณ ให้ใช้ Google Play Console แทน นอกจากนี้ โปรดทราบว่า API แสดงเฉพาะรีวิวที่มีความคิดเห็น หากผู้ใช้ให้คะแนนแอป ไม่แสดงความคิดเห็น ผู้ใช้จะไม่สามารถเข้าถึงความคิดเห็นได้จาก API

การรับสิทธิ์เข้าถึง

ในการทำงานกับ API การตอบกลับรีวิว คุณจะต้องให้สิทธิ์โดยใช้ ไคลเอ็นต์ OAuth หรือบัญชีบริการ หากใช้บัญชีบริการ ให้เปิดใช้ "ตอบรีวิว" สิทธิ์ภายในบัญชีนี้ สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ การสร้างการเข้าถึงที่ได้รับอนุญาตสำหรับ API นี้ โปรดดู การตั้งค่าไคลเอ็นต์การเข้าถึง API

การดึงข้อมูลรีวิว

เมื่อใช้ 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"
  }
}

ผลลัพธ์แต่ละรายการจะมีข้อมูลเมตาต่อไปนี้

reviewId

ระบุรีวิวนี้แบบไม่ซ้ำกัน และยังระบุถึง เนื่องจากผู้ใช้จะเขียนรีวิวได้เพียงรายการเดียวสำหรับแอปหนึ่งๆ

authorName

ชื่อของผู้ใช้ที่เขียนรีวิว

หมายเหตุ: ในบางกรณี authorName อาจ ไม่ปรากฏในผลการค้นหาที่ระบุ

ความคิดเห็น

รายการที่มีความคิดเห็นของผู้ใช้เกี่ยวกับแอป หากสิ่งนี้ รีวิวมีชื่อ จากนั้นทั้งชื่อนี้และข้อความเนื้อหาของรีวิวจะปรากฏ ในองค์ประกอบ text และอักขระ Tab จะแยกชื่อและเนื้อหาออกจากกัน องค์ประกอบ lastModified ระบุเวลาที่ผู้ใช้ล่าสุด ส่งรีวิวแล้ว

หากคุณได้ตอบกลับความเห็นนี้แล้ว ความคิดเห็นของคุณจะปรากฏเป็น องค์ประกอบที่สองในรายการความคิดเห็น

starRating

การประเมินแอปของผู้ใช้ในระดับ 1-5 5 คะแนน บ่งบอกว่าผู้ใช้มีความพึงพอใจกับแอปของคุณเป็นอย่างสูง

โดยค่าเริ่มต้นจะมีรีวิว 10 รายการในแต่ละหน้า คุณแสดงรีวิวได้สูงสุด 100 รายการ ต่อหน้าโดยการตั้งค่าพารามิเตอร์ maxResults ในคำขอ

หากรายการรีวิวต่อเนื่องไปยังหน้าอื่น API จะรวม องค์ประกอบ tokenPagination ในการตอบกลับ เมื่อขอหน้าถัดไปของ ให้ใส่องค์ประกอบ token ตั้งค่าขององค์ประกอบนี้เป็น nextPageToken ซึ่งปรากฏในการตอบกลับเดิม

หมายเหตุ: คุณเรียกดูได้เฉพาะรีวิวที่ผู้ใช้สร้างไว้เท่านั้น หรือแก้ไขภายในสัปดาห์ที่ผ่านมา ถ้าต้องการดูรีวิวทั้งหมด ตั้งแต่ต้น คุณสามารถดาวน์โหลด รีวิวในรูปแบบไฟล์ CSV โดยใช้ Google Play Console

ตัวอย่างต่อไปนี้ของคำขอ GET จะแสดงหน้าถัดไปของรีวิว ช่วงเวลานี้ ถือว่าหน้าการตรวจสอบปัจจุบัน (ดังที่แสดงไว้ในการตอบกลับของ คำขอก่อนหน้า) มีค่า nextPageToken เป็น "12334566" ยังระบุว่าหน้าถัดไปควรแสดงรีวิวสูงสุด 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!"
}

หมายเหตุ: replyText ที่คุณรวมไว้กับ คำขอ POST มีอักขระได้สูงสุด 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 รายการ (สำหรับการตอบกลับรีวิว) - 2,000 รายการต่อวัน

หากแอปของคุณต้องดึงข้อมูลหรือตอบกลับรีวิวในจำนวนที่มากกว่านี้ อนุญาต ส่ง ส่งคำขอ เพื่อเพิ่มโควต้าของแอป