回覆評論

您可以透過 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 次

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