리뷰에 대한 응답 제출

  • 아티클

Important

이 항목에 설명된 대로 Microsoft Store 리뷰 API는 현재 운영 중 상태가 아닙니다. API를 사용하는 대신 파트너 센터를 사용하여 동일한 작업을 수행할 수 있습니다.

Microsoft Store 리뷰 API에서 이 메서드를 사용하여 앱 리뷰에 프로그래밍 방식으로 응답할 수 있습니다. 이 메서드를 호출하는 경우 응답하려는 리뷰의 ID를 지정해야 합니다. 리뷰 ID는 Microsoft Store 분석 API의 앱 리뷰 가져오기 메서드의 응답 데이터와 리뷰 보고서의 오프라인 다운로드에서 사용할 수 있습니다.

리뷰를 제출하는 고객은 해당 리뷰에 대한 응답을 받지 않기로 선택할 수 있습니다. 고객이 응답을 받지 않겠다고 선택한 리뷰에 응답하려 하면 이 메서드의 응답 본문이 응답 시도가 실패한 것으로 나타냅니다. 이 메서드를 호출하기 전에 선택적으로 앱 리뷰에 대한 응답 정보 가져오기 메서드를 사용하여 지정된 리뷰에 응답할 수 있는지 여부를 확인할 수 있습니다.

참고 항목

이 메서드를 사용하여 프로그래밍 방식으로 리뷰에 응답하는 이외에, 파트너 센터를 사용하여 리뷰에 응답할 수도 있습니다.

필수 조건

이 메서드를 사용하려면 먼저 다음을 수행해야 합니다.

요청

요청 구문

메서드 요청 URI
게시 https://manage.devcenter.microsoft.com/v1.0/my/reviews/responses

요청 헤더

헤더 유형 설명
Authorization 문자열 필수. Bearer<토큰> 형식의 Azure AD 액세스 토큰입니다.

요청 매개 변수

이 메서드에는 요청 매개 변수가 없습니다.

요청 본문

요청 본문에는 다음 값이 포함됩니다.

값 Type 설명
응답 배열 제출할 응답 데이터를 포함하는 개체의 배열입니다. 각 개체의 데이터에 대한 자세한 내용은 다음 표를 참조하세요.

응답 배열의 각 객체에는 다음 값이 포함됩니다.

값 Type 설명 필수
ApplicationId string 응답할 리뷰가 포함된 앱의 스토어 ID입니다. 스토어 ID는 파트너 센터의 앱 ID 페이지에서 사용할 수 있습니다. 예를 들어 Store ID는 9WZDNCRFJ3Q8입니다. 예
ReviewId string 응답하려는 리뷰의 ID(GUID)입니다. 리뷰 ID는 Microsoft Store 분석 API의 앱 리뷰 가져오기 메서드의 응답 데이터와 리뷰 보고서의 오프라인 다운로드에서 사용할 수 있습니다. 예
ResponseText string 제출할 응답입니다. 응답은 이 지침을 따라 합니다. 예
SupportEmail string 고객이 직접 문의할 때 사용할 수 있는 앱 지원 이메일 주소입니다. 유효한 메일 주소여야 합니다. 예
IsPublic Boolean true를 지정할 경우 응답이 앱의 스토어 목록에서 고객 리뷰 바로 밑에 표시되고 모든 고객에게 노출됨을 나타냅니다. false를 지정하면 사용자가 이메일 응답 수신을 옵트아웃하지 않은 경우 메일을 통해 고객에게 응답이 전송되고 앱의 Store 목록에 있는 다른 고객에게는 표시되지 않습니다. false를 지정하면 사용자가 이메일 응답 수신을 옵트아웃한 경우 오류가 반환됩니다. 예

요청 예제

다음 예제는 이 메서드를 사용하여 여러 리뷰에 대해 응답을 제출하는 방법입니다.

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
    }
  ]
}

응답

응답 본문

값 Type Description
결과 배열 제출한 각 응답에 대한 데이터를 포함하는 개체의 배열입니다. 각 개체의 데이터에 대한 자세한 내용은 다음 표를 참조하세요.

결과 배열의 각 객체에는 다음 값이 포함됩니다.

값 Type 설명
ApplicationId string 응답한 리뷰가 포함된 앱의 스토어 ID입니다. 예를 들어 Store ID는 9WZDNCRFJ3Q8입니다.
ReviewId string 응답한 리뷰의 ID입니다. GUID입니다.
성공 string 값 true는 응답이 성공적으로 전송되었음을 나타냅니다. 값 false 응답이 실패했음을 나타냅니다.
FailureReason string 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"
    }
  ]
}