리뷰에 대한 응답 제출Submit responses to reviews

Microsoft Store 리뷰 API에서이 방법을 사용 하 여 프로그래밍 방식으로 앱 검토에 응답 합니다.Use this method in the Microsoft Store reviews API to programmatically respond to reviews of your app. 이 메서드를 호출 하는 경우 응답 하려는 검토의 Id를 지정 해야 합니다.When you call this method, you must specify the IDs of the reviews you want to respond to. 검토 Id는 Microsoft Store 분석 API 및 검토 보고서오프 라인 다운로드 에서 앱 검토 가져오기 메서드의 응답 데이터에서 사용할 수 있습니다.Review IDs are available in the response data of the get app reviews method in the Microsoft Store analytics API and in the offline download of the Reviews report.

고객은 리뷰를 제출할 때 해당 검토에 대 한 응답을 수신 하지 않도록 선택할 수 있습니다.When a customer submits a review, they can choose not to receive responses to their review. 고객이 응답을 수신 하지 않기로 선택한 리뷰에 응답 하려는 경우이 메서드의 응답 본문은 응답 시도가 실패 했음을 표시 합니다.If you try to respond to a review for which the customer chose not to receive responses, the response body of this method will indicate that the response attempt was unsuccessful. 이 메서드를 호출 하기 전에 앱 검토에 대 한 응답 정보 가져오기 방법을 사용 하 여 지정 된 검토에 응답할 수 있는지 여부를 선택적으로 결정할 수 있습니다.Before calling this method, you can optionally determine whether you are allowed to respond to a given review by using the get response info for app reviews method.

참고

이 메서드를 사용 하 여 프로그래밍 방식으로 검토에 응답 하는 것 외에도 파트너 센터를 사용 하 여리뷰에 응답할 수 있습니다.In addition to using this method to programmatically respond to reviews, you can alternatively respond to reviews using Partner Center.

필수 구성 요소Prerequisites

이 방법을 사용 하려면 먼저 다음을 수행 해야 합니다.To use this method, you need to first do the following:

  • 아직 수행 하지 않은 경우 Microsoft Store 리뷰 API에 대 한 모든 필수 구성 요소 를 완료 합니다.If you have not done so already, complete all the prerequisites for the Microsoft Store reviews API.
  • 이 메서드에 대 한 요청 헤더에 사용할 AZURE AD 액세스 토큰을 가져옵니다 .Obtain an Azure AD access token to use in the request header for this method. 액세스 토큰을 얻은 후 만료되기 전에 60분 동안 사용할 수 있습니다.After you obtain an access token, you have 60 minutes to use it before it expires. 토큰이 만료 된 후 새 토큰을 얻을 수 있습니다.After the token expires, you can obtain a new one.
  • 응답 하려는 검토의 Id를 가져옵니다.Get the IDs of the reviews you want to respond to. 검토 Id는 Microsoft Store 분석 API 및 검토 보고서오프 라인 다운로드 에서 앱 검토 가져오기 메서드의 응답 데이터에서 사용할 수 있습니다.Review IDs are available in the response data of the get app reviews method in the Microsoft Store analytics API and in the offline download of the Reviews report.

요청Request

요청 구문Request syntax

방법Method 요청 URIRequest URI
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/reviews/responses

요청 헤더Request header

headerHeader 유형Type DescriptionDescription
권한 부여Authorization 문자열string 필수 요소.Required. Bearer <token> 형식의 Azure AD 액세스 토큰입니다.The Azure AD access token in the form Bearer <token>.

요청 매개 변수Request parameters

이 메서드에는 요청 매개 변수가 없습니다.This method has no request parameters.

요청 본문Request body

요청 본문의 값은 다음과 같습니다.The request body has the following values.

Value TypeType DescriptionDescription
응답Responses arrayarray 전송 하려는 응답 데이터를 포함 하는 개체의 배열입니다.An array of objects that contain the response data you want to submit. 각 개체의 데이터에 대 한 자세한 내용은 다음 표를 참조 하십시오.For more information about the data in each object, see the following table.

응답 배열의 각 개체에는 다음 값이 포함 됩니다.Each object in the Responses array contains the following values.

Value TypeType DescriptionDescription 필수Required
ApplicationIdApplicationId 문자열string 응답 하려는 검토가 포함 된 앱의 저장소 ID입니다.The Store ID of the app with the review you want to respond to. 저장소 ID는 파트너 센터의 앱 id 페이지 에서 사용할 수 있습니다.The Store ID is available on the App identity page of Partner Center. 예 매장 ID는 9WZDNCRFJ3Q8입니다.An example Store ID is 9WZDNCRFJ3Q8. Yes
ReviewIdReviewId 문자열string 응답 하려는 검토의 ID (GUID)입니다.The ID of the review you want to respond to (this is a GUID). 검토 Id는 Microsoft Store 분석 API 및 검토 보고서오프 라인 다운로드 에서 앱 검토 가져오기 메서드의 응답 데이터에서 사용할 수 있습니다.Review IDs are available in the response data of the get app reviews method in the Microsoft Store analytics API and in the offline download of the Reviews report. Yes
ResponseTextResponseText 문자열string 전송 하려는 응답입니다.The response you want to submit. 응답은 다음 지침을 따라야 합니다.Your response must follow these guidelines. Yes
SupportEmailSupportEmail 문자열string 고객이 직접 연락 하는 데 사용할 수 있는 앱의 지원 전자 메일 주소입니다.Your app's support email address, which the customer can use to contact you directly. 유효한 전자 메일 주소 여야 합니다.This must be a valid email address. Yes
IsPublicIsPublic 부울Boolean True를 지정 하면 고객의 검토 바로 아래에 앱의 스토어 목록에 응답이 표시 되 고 모든 고객에 게 표시 됩니다.If you specify true, your response will be displayed in your app's Store listing, directly below the customer's review, and will be visible to all customers. False 를 지정 하 고 사용자가 전자 메일 응답을 받을 수 없는 경우, 전자 메일을 통해 고객에 게 응답이 전송 되며, 앱의 스토어 목록에서 다른 고객에 게 표시 되지 않습니다.If you specify false and the user hasn't opted out of receiving email responses, your response will be sent to the customer via email, and it will not be visible to other customers in your app's Store listing. False 를 지정 하 고 사용자가 전자 메일 응답을 받을 수 없는 경우 오류가 반환 됩니다.If you specify false and the user has opted out of receiving email responses, an error will be returned. Yes

요청 예제Request example

다음 예제에서는이 메서드를 사용 하 여 여러 검토에 응답을 전송 하는 방법을 보여 줍니다.The following example demonstrates how to use this method to submit responses to several reviews.

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

응답Response

응답 본문Response body

Value TypeType DescriptionDescription
결과Result arrayarray 제출한 각 응답에 대 한 데이터를 포함 하는 개체의 배열입니다.An array of objects that contain data about each response you submitted. 각 개체의 데이터에 대 한 자세한 내용은 다음 표를 참조 하십시오.For more information about the data in each object, see the following table.

결과 배열의 각 개체에는 다음 값이 포함 됩니다.Each object in the Result array contains the following values.

Value TypeType DescriptionDescription
ApplicationIdApplicationId 문자열string 응답 한 검토가 있는 앱의 저장소 ID입니다.The Store ID of the app with the review you responded to. 예 매장 ID는 9WZDNCRFJ3Q8입니다.An example Store ID is 9WZDNCRFJ3Q8.
ReviewIdReviewId 문자열string 응답 한 검토의 ID입니다.The ID of the review you responded to. GUID입니다.This is a GUID.
성공Successful 문자열string True 값은 응답이 성공적으로 전송 되었음을 나타냅니다.The value true indicates that your response was sent successfully. False 값은 응답에 실패 했음을 나타냅니다.The value false indicates that your response was unsuccessful.
FailureReasonFailureReason 문자열string 성공false이면이 값에 실패의 이유가 포함 됩니다.If Successful is false, this value contains a reason for the failure. 성공true이면이 값이 비어 있습니다.If Successful is true, this value is empty.

응답 예제Response example

다음 예제에서는이 요청에 대 한 예제 JSON 응답 본문을 보여 줍니다.The following example demonstrates an example JSON response body for this request.

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