本頁面由 Cloud Translation API 翻譯而成。

回覆評論

您可以透過 Google Play Developer Reply to Reviews API 查看使用者意見回饋並回覆這則意見。您可以使用這個 API 直接在現有的客戶服務工具包中 (例如客戶關係管理系統) 有些人會將 Cloud Storage 視為檔案系統但實際上不是

Reply to Review API 只能讓你存取正式版的意見回饋各個應用程式版本針對 Alpha 或 Beta 版請改用 Google Play 管理中心另外請注意僅顯示含有留言的評論。如果使用者對應用程式評分未提供註解，否則無法透過 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"
  }
}

每項結果都包含下列中繼資料：

reviewId

此評論的專屬編號。也會指出因為使用者只能針對特定應用程式撰寫一則評論。

authorName

撰寫評論的使用者名稱。

注意：在極少數情況下，authorName 可能會也不會出現在特定結果中

comments

含有使用者對應用程式意見回饋的清單。如果這是評論會包含標題，然後顯示標題和評論內文在 text 元素中，定位點字元可用來分隔標題和內文。 lastModified 元素會顯示使用者最近一次造訪的時間已提交評論

如果您已回覆這則評論，則您的意見回饋會顯示為加入註解清單中的第二個元素

starRating

使用者以 1 到 5 的評分等級評估您的應用程式。5 分表示使用者對您的應用程式非常滿意。

根據預設，每個頁面會顯示 10 則評論。您最多可以顯示 100 則評論方法是在要求中設定 maxResults 參數。

如果其他頁面的評論清單持續增加，API 會包含回應中的 tokenPagination 元素。要求下一頁的則請加入 token 元素。將此元素的值設為 nextPageToken 值，顯示在原始回應中。

注意：你只能擷取使用者建立的評論或最近一週內修改過若要擷取這個應用程式使用 Google Play 管理中心的 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
      }
    }
  ]
}

翻譯評論文字

評論文字可在傳回前自動翻譯 Review 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 項要求 (用於回覆評論) – 每天 2000 次

如果您的應用程式需要擷取或回覆的評論數量超過這些文字配額允許，要求增加應用程式的配額