提交評論的回應

  • 發行項

重要

如本主題所述，Microsoft Store 評論 API 目前未處於運作中狀態。 與其使用 API，您可以使用合作夥伴中心來完成相同的工作。

在 Microsoft Store 評論 API 中使用此方法，以透過程式設計方式，回應應用程式的評論。 當您呼叫此方法時，您必須指定您想要回應之評論的識別碼。 評論識別碼可在 Microsoft Store 分析 API 和評論報告的離線下載中取得應用程式評論方法的回覆資料中取得。

當客戶提交評論時，他們可以選擇不要收到評論的回應。 對於客戶選擇不接收回應的評論，如果您嘗試回應者，這個方法的回應本文會指出嘗試回應失敗。 呼叫此方法之前，您可以選擇性地使用 取得應用程式評論的回應資訊方法，判斷您是否可以回應特定評論 。

注意

除了使用此方法透過程序設計方式回應評論之外，您也可以使用合作夥伴中心回應評論。

必要條件

要使用此方法，您需要先執行以下操作：

  • 如果您尚未執行此操作，請完成 Microsoft Store 評論 API 的所有 先決條件 。
  • 取得 Azure AD 存取權杖以便在此方法的要求標頭中使用 。 取得存取權杖之後，您在其到期之前有 60 分鐘的時間可以使用。 權杖到期之後，您可以取得新的權杖。
  • 取得您想要回應之評論的識別碼。 評論識別碼可在 Microsoft Store 分析 API 和評論報告的離線下載中取得應用程式評論方法的回覆資料中取得。

Request

要求語法

方法 要求 URI
POST https://manage.devcenter.microsoft.com/v1.0/my/reviews/responses

要求標頭

標題 類型 描述
授權 字串 必要。 持有人<權杖>形式的 Azure AD 存取權杖。

要求參數

這個方法沒有任何要求參數。

要求本文

要求本文具有以下值。

值 類型 描述
回覆 陣列 還有您想要提交的回應資料的物件陣列。 如需每個物件中資料的詳細資訊，請參閱下表。

回覆 陣列中的每個物件都包含下列值。

值 類型 描述 必要
ApplicationId 字串 含有您想要回應的評論的應用程式的 Store 識別碼。 Store ID 可在合作夥伴中心的應用程式身分識別頁面上取得。 範例 Store 識別碼 為 9WZDNCRFJ3Q8。 是
ReviewId 字串 您想要回應的評論的識別碼（此為 GUID）。 評論識別碼可在 Microsoft Store 分析 API 和評論報告的離線下載中取得應用程式評論方法的回覆資料中取得。 Yes
ResponseText 字串 您想提交的回應。 您的回應必須遵循 這些指導方針。 Yes
SupportEmail 字串 您的應用程式支援電子郵件地址，可以讓客戶用來直接跟您聯絡。 必須是有效的電子郵件地址。 Yes
IsPublic 布林值 如果您指定為 true，您的回應就會顯示在您應用程式的 Store 清單中，緊接在客戶評論下方，而且所有客戶都看得到。 如果您指定為 false ，且使用者並未選擇不接收電子郵件回應者，您的回應會透過電子郵件傳送給客戶，而其他客戶無法在應用程式的 Store 清單中看見該回應。 如果您指定為 false ，且使用者已選擇不接收電子郵件回應者，會傳回錯誤。 Yes

要求範例

以下範例示範如何使用此方法把回應提交至數個評論。

POST https://manage.devcenter.microsoft.com/v1.0/my/reviews/responses HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
  "Responses": [
    {
      "ApplicationId": "9WZDNCRFJ3Q8",
      "ReviewId": "6be543ff-1c9c-4534-aced-af8b4fbe0316",
      "ResponseText": "Thank you for pointing out this bug. I fixed it and published an update, you should have the fix soon",
      "SupportEmail": "support@contoso.com",
      "IsPublic": true
    },
    {
      "ApplicationId": "9NBLGGH1RP08",
      "ReviewId": "80c9671a-96c2-4278-bcbc-be0ce5a32a7c",
      "ResponseText": "Thank you for submitting your review. Can you tell more about what you were doing in the app when it froze? Thanks very much for your help.",
      "SupportEmail": "support@contoso.com",
      "IsPublic": false
    }
  ]
}

回應

回應本文

值 類型 描述
結果 陣列 包含您已提交之每個回應相關資料的物件陣列。 如需每個物件中資料的詳細資訊，請參閱下表。

結果 陣列中的每個物件都包含下列值。

值 類型 描述
ApplicationId 字串 含有您已回應的評論的應用程式的 Store 識別碼。 範例 Store 識別碼 為 9WZDNCRFJ3Q8。
ReviewId 字串 您已回應之評論的識別碼。 這是 GUID。
成功 字串 true 值表示您的回應已成功傳送。 false 值表示您的回應失敗。
FailureReason 字串 如果 Successful 為 false，這個值會包含失敗的原因。 如果 Successful 為 true，這個值會是空的。

回應範例

下列範例示範此要求的範例 JSON 回應本文。

{
  "Result": [
    {
      "ApplicationId": "9WZDNCRFJ3Q8",
      "ReviewId": "6be543ff-1c9c-4534-aced-af8b4fbe0316",
      "Successful": "true",
      "FailureReason": ""
    },
    {
      "ApplicationId": "9NBLGGH1RP08",
      "ReviewId": "80c9671a-96c2-4278-bcbc-be0ce5a32a7c",
      "Successful": "false",
      "FailureReason": "No Permission"
    }
  ]
}