Enviar respuestas a opinionesSubmit responses to reviews

Use este método en la API de Microsoft Store Reviews para responder mediante programación a las revisiones de la aplicación.Use this method in the Microsoft Store reviews API to programmatically respond to reviews of your app. Cuando llame a este método, debe especificar los identificadores de las revisiones a las que desea responder.When you call this method, you must specify the IDs of the reviews you want to respond to. Los identificadores de revisión están disponibles en los datos de respuesta del método Get App Reviews de la API de Microsoft Store Analytics y en la descarga sin conexión del Informe de revisiones.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.

Cuando un cliente envía una revisión, puede optar por no recibir respuestas a su revisión.When a customer submits a review, they can choose not to receive responses to their review. Si intenta responder a una revisión para la que el cliente decidió no recibir respuestas, el cuerpo de respuesta de este método indicará que el intento de respuesta no se ha realizado correctamente.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. Antes de llamar a este método, puede determinar opcionalmente si se le permite responder a una revisión determinada mediante el método Get Response info for App Reviews .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.

Nota

Además de usar este método para responder mediante programación a las revisiones, puede responder de forma alternativa a las revisiones mediante el centro de Partners.In addition to using this method to programmatically respond to reviews, you can alternatively respond to reviews using Partner Center.

PrerrequisitosPrerequisites

Para usar este método, primero debes hacer lo siguiente:To use this method, you need to first do the following:

  • Si todavía no lo ha hecho, complete todos los requisitos previos de la API de Microsoft Store Reviews.If you have not done so already, complete all the prerequisites for the Microsoft Store reviews API.
  • Obtén un token de acceso de Azure AD para usarlo en el encabezado de la solicitud de este método.Obtain an Azure AD access token to use in the request header for this method. Una vez que haya obtenido un token de acceso, tiene 60 minutos para usarlo antes de que expire.After you obtain an access token, you have 60 minutes to use it before it expires. Si el token expira, puedes obtener uno nuevo.After the token expires, you can obtain a new one.
  • Obtenga los identificadores de las revisiones a las que desea responder.Get the IDs of the reviews you want to respond to. Los identificadores de revisión están disponibles en los datos de respuesta del método Get App Reviews de la API de Microsoft Store Analytics y en la descarga sin conexión del Informe de revisiones.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.

SolicitudRequest

Sintaxis de la solicitudRequest syntax

MétodoMethod URI de la solicitudRequest URI
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/reviews/responses

Encabezado de solicitudRequest header

EncabezadoHeader TipoType DescripciónDescription
AuthorizationAuthorization stringstring Necesario.Required. El token de acceso de Azure AD del formulario Bearer <token>.The Azure AD access token in the form Bearer <token>.

Parámetros de solicitudRequest parameters

Este método no tiene parámetros de solicitud.This method has no request parameters.

Cuerpo de la solicitudRequest body

El cuerpo de la solicitud tiene los siguientes valores.The request body has the following values.

ValueValue TipoType DescripciónDescription
RespuestasResponses arrayarray Matriz de objetos que contiene los datos de respuesta que se van a enviar.An array of objects that contain the response data you want to submit. Para obtener más información acerca de los datos de cada objeto, vea la tabla siguiente.For more information about the data in each object, see the following table.

Cada objeto de la matriz de respuestas contiene los siguientes valores.Each object in the Responses array contains the following values.

ValueValue TipoType DescripciónDescription ObligatorioRequired
ApplicationIdApplicationId stringstring El identificador de la tienda de la aplicación con la revisión a la que desea responder.The Store ID of the app with the review you want to respond to. El identificador de almacén está disponible en la Página identidad de la aplicación del centro de Partners.The Store ID is available on the App identity page of Partner Center. Un ejemplo de un id. de la Tienda sería 9WZDNCRFJ3Q8.An example Store ID is 9WZDNCRFJ3Q8. Yes
ReviewIdReviewId stringstring IDENTIFICADOR de la revisión a la que se desea responder (es un GUID).The ID of the review you want to respond to (this is a GUID). Los identificadores de revisión están disponibles en los datos de respuesta del método Get App Reviews de la API de Microsoft Store Analytics y en la descarga sin conexión del Informe de revisiones.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 stringstring Respuesta que se desea enviar.The response you want to submit. La respuesta debe seguir estas instrucciones.Your response must follow these guidelines. Yes
SupportEmailSupportEmail stringstring La dirección de correo electrónico de soporte técnico de la aplicación, que el cliente puede usar para ponerse en contacto con usted directamente.Your app's support email address, which the customer can use to contact you directly. Debe ser una dirección de correo electrónico válida.This must be a valid email address. Yes
IsPublicIsPublic BooleanBoolean Si especifica true, la respuesta se mostrará en la lista de la tienda de la aplicación, directamente debajo de la revisión del cliente, y será visible para todos los clientes.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. Si especifica false y el usuario no ha optado por recibir respuestas de correo electrónico, la respuesta se enviará al cliente por correo electrónico y no será visible para otros clientes de la lista de tiendas de la aplicación.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. Si especifica false y el usuario ha optado por no recibir respuestas de correo electrónico, se devolverá un error.If you specify false and the user has opted out of receiving email responses, an error will be returned. Yes

Ejemplo de solicitudRequest example

En el ejemplo siguiente se muestra cómo utilizar este método para enviar respuestas a varias revisiones.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
    }
  ]
}

ResponseResponse

Response bodyResponse body

ValueValue TipoType DescripciónDescription
ResultadoResult arrayarray Matriz de objetos que contienen datos sobre cada respuesta enviada.An array of objects that contain data about each response you submitted. Para obtener más información acerca de los datos de cada objeto, vea la tabla siguiente.For more information about the data in each object, see the following table.

Cada objeto de la matriz de resultados contiene los siguientes valores.Each object in the Result array contains the following values.

ValueValue TipoType DescripciónDescription
ApplicationIdApplicationId stringstring El identificador de la tienda de la aplicación con la revisión a la que ha respondido.The Store ID of the app with the review you responded to. Un ejemplo de un id. de la Tienda sería 9WZDNCRFJ3Q8.An example Store ID is 9WZDNCRFJ3Q8.
ReviewIdReviewId stringstring El identificador de la revisión a la que ha respondido.The ID of the review you responded to. Este identificador es un GUID.This is a GUID.
CorrectoSuccessful stringstring El valor true indica que la respuesta se envió correctamente.The value true indicates that your response was sent successfully. El valor false indica que la respuesta no se ha realizado correctamente.The value false indicates that your response was unsuccessful.
FailureReasonFailureReason stringstring Si el resultado es false, este valor contiene una razón para el error.If Successful is false, this value contains a reason for the failure. Si es true, este valor está vacío .If Successful is true, this value is empty.

Ejemplo de respuestaResponse example

En el ejemplo siguiente se muestra el cuerpo de una respuesta JSON de ejemplo realizada para esta solicitud.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"
    }
  ]
}