Obtener información de respuesta de opinionesGet response info for reviews

Si quieres responder mediante programación a una opinión del cliente sobre la aplicación, puedes usar este método en la API de opiniones de Microsoft Store para determinar primero si tienes permiso para responder.If you want to programmatically respond to a customer review of your app, you can use this method in the Microsoft Store reviews API to first determine whether you have permission to respond to the review. No puedes responder a opiniones enviadas por clientes que han elegido no recibir respuestas a opiniones.You cannot respond to reviews submitted by customers who have chosen not to receive review responses. Después de confirmar que puedes responder a la opinión, puedes usar el método de Submit responses to app reviews (Enviar respuestas a las opiniones de la aplicación para responderla mediante programación.After you confirm that you can respond to the review, you can then use the submit responses to app reviews method to programmatically respond to it.

Requisitos previosPrerequisites

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

  • Si aún no lo has hecho, completa todos los requisitos previos para la API de análisis de Microsoft Store.If you have not done so already, complete all the prerequisites for the Microsoft Store analytics 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. Después de obtener un token de acceso, tienes 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.
  • Obtén el ID de la opinión que quieras comprobar para determinar si puedes responderla.Get the ID of the review you want to check to determine whether you can respond to it. Los identificadores de opinión están disponibles en los datos de respuesta del método obtener opiniones de la aplicación en la API de análisis de Microsoft Store y en la descarga sin conexión del informe de opiniones.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
GETGET https://manage.devcenter.microsoft.com/v1.0/my/reviews/{reviewId}/apps/{applicationId}/responses/info

Encabezado de la solicitudRequest header

HeaderHeader TipoType DescripciónDescription
AutorizaciónAuthorization stringstring Obligatorio.Required. El token de acceso de Azure AD en el formulario portador < token>.The Azure AD access token in the form Bearer <token>.

Parámetros de solicitudRequest parameters

ParámetroParameter TipoType DescripciónDescription RequeridoRequired
applicationIdapplicationId stringstring El identificador de la aplicación que contiene la opinión que quieres determinar si puedes responder.The Store ID of the app that contains the review for which you want to determine whether you can respond to. El identificador de Store está disponible en el página identidad de aplicación en el centro de partners.The Store ID is available on the App identity page in Partner Center. Un ejemplo de un id. de la Tienda sería 9WZDNCRFJ3Q8.An example Store ID is 9WZDNCRFJ3Q8. Yes
reviewIdreviewId stringstring El identificador de la opinión que quieres responder (es un GUID).The ID of the review you want to respond to (this is a GUID). Los identificadores de opinión están disponibles en los datos de respuesta del método obtener opiniones de la aplicación en la API de análisis de Microsoft Store y en la descarga sin conexión del informe de opiniones.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.
Si omites este parámetro, el cuerpo de respuesta de este método indicará si dispones de permisos para responder a opiniones de la aplicación especificada.If you omit this parameter, the response body for this method will indicate whether you have permissions to respond to any reviews for the specified app.
NoNo

Ejemplo de solicitudRequest example

En los siguientes ejemplos se muestra cómo usar este método para determinar si puedes responder a una opinión determinada.The following examples how to use this method to determine whether you can respond to a given review.

GET https://manage.devcenter.microsoft.com/v1.0/my/reviews/6be543ff-1c9c-4534-aced-af8b4fbe0316/apps/9WZDNCRFJ3Q8/responses/info HTTP/1.1
Authorization: Bearer <your access token>

RespuestaResponse

Cuerpo de la respuestaResponse body

ValorValue TipoType DescripciónDescription
CanRespondCanRespond BooleanoBoolean El valor true indica que puedes responder a la opinión especificada o que tienes permisos para responder a cualquier opinión de la aplicación especificada.The value true indicates that you can respond to the specified review, or that you have permissions to respond to any review for the specified app. De lo contrario, este valor es false.Otherwise, this value is false.
DefaultSupportEmailDefaultSupportEmail stringstring La dirección de correo electrónico de soporte técnico de tu aplicación según se indica en la lista de aplicaciones de la Store.Your app's support email address as specified in your app's Store listing. Si no especificaste ninguna dirección de correo electrónico de soporte técnico, este campo estará vacío.If you did not specify a support email address, this field 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.

{
  "CanRespond": true,
  "DefaultSupportEmail": "support@contoso.com"
}