提交評論的回應
重要
如本主題所述，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"
}
]
}