Compartir a través de

Enviar respuestas a revisiones

Importante

El Microsoft Store revisa la API, como se documenta en este tema, actualmente no está en estado de trabajo. En lugar de usar las API, puede lograr las mismas tareas mediante el Centro de socios.

Usa este método en la API de opiniones de Microsoft Store para responder mediante programación a las revisiones de la aplicación. Al llamar a este método, debe especificar los identificadores de las revisiones a las que desea responder. Los identificadores de opinión están disponibles en los datos de respuesta del método obtener opiniones de aplicaciones en la API de análisis de la Microsoft Store y en la descarga sin conexión del informe de Opiniones .

Cuando un cliente envía una revisión, puede optar por no recibir respuestas a su revisión. Si intenta responder a una revisión para la que el cliente eligió no recibir respuestas, el cuerpo de la respuesta de este método indicará que el intento de respuesta no se realizó correctamente. Antes de llamar a este método, puede optar por determinar si tiene permitido responder a una reseña específica mediante el método para obtener información sobre las respuestas a las opiniones de aplicaciones.

Nota:

Además de usar este método para responder de manera programática a las reseñas, también puede responder a las reseñas a través del Partner Center.

Prerrequisitos

Para usar este método, primero debe hacer lo siguiente:

  • Si aún no lo ha hecho, complete todos los requisitos previos para la API de reseñas de la Tienda Microsoft.
  • Obtenga un token de acceso de Azure AD para usarlo en el encabezado de solicitud para este método. Después de obtener un token de acceso, tiene 60 minutos para usarlo antes de que expire. Una vez que expire el token, puede obtener uno nuevo.
  • Obtén los identificadores de las opiniones a las que quieres responder. Los identificadores de opinión están disponibles en los datos de respuesta del método obtener opiniones de aplicaciones en la API de análisis de la Microsoft Store y en la descarga sin conexión del informe de Opiniones .

Solicitud

Sintaxis de la solicitud

Método Solicitud de URI
PUBLICACIÓN https://manage.devcenter.microsoft.com/v1.0/my/reviews/responses

Cabecera de solicitud

Cabecera Tipo Descripción
Autorización cuerda / cadena Obligatorio. El token de acceso de Azure AD en la forma Bearer<token>.

Parámetros de solicitud

Este método no tiene parámetros de solicitud.

Cuerpo de la solicitud

El cuerpo de la solicitud tiene los siguientes valores.

Importancia Tipo Descripción
Respuestas arreglo Matriz de objetos que contienen los datos de respuesta que desea enviar. Para obtener más información sobre los datos de cada objeto, vea la tabla siguiente.

Cada objeto de la matriz Responses contiene los valores siguientes.

Importancia Tipo Descripción Obligatorio
ApplicationId cuerda / cadena El ID de la tienda de la aplicación con la reseña a la que quieres responder. El identificador de la Tienda está disponible en la página de identidad de la aplicación del Centro de partners. Un ID de tienda como ejemplo es 9WZDNCRFJ3Q8. Sí
ReviewId cuerda / cadena Identificador de la revisión a la que desea responder (GUID). Los identificadores de opinión están disponibles en los datos de respuesta del método obtener opiniones de aplicaciones en la API de análisis de la Microsoft Store y en la descarga sin conexión del informe de Opiniones . Sí
TextoDeRespuesta cuerda / cadena Respuesta que desea enviar. La respuesta debe seguir estas directrices. Sí
Correo de Soporte cuerda / cadena 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. Debe ser una dirección de correo electrónico válida. Sí
IsPublic Booleano Si especificas true, tu respuesta se mostrará en la ficha en la Tienda de la aplicación, directamente debajo de la reseña del cliente y estará visible para todos los clientes. Si especificas false y el usuario no ha optado por no recibir respuestas de correo electrónico, la respuesta se enviará al cliente por correo electrónico y no será visible para otros clientes en la descripción de la Tienda de la aplicación. Si especifica false y el usuario ha optado por no recibir respuestas de correo electrónico, se devolverá un error. Sí

Ejemplo de solicitud

En el ejemplo siguiente se muestra cómo usar este método para enviar respuestas a varias revisiones.

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

Respuesta

Cuerpo de respuesta

Importancia Tipo Descripción
Resultado arreglo Matriz de objetos que contienen datos sobre cada respuesta enviada. Para obtener más información sobre los datos de cada objeto, vea la tabla siguiente.

Cada objeto de la matriz result contiene los siguientes valores.

Importancia Tipo Descripción
ApplicationId cuerda / cadena El ID de la Tienda de la aplicación con la reseña a la que respondió. Un ID de tienda como ejemplo es 9WZDNCRFJ3Q8.
ReviewId cuerda / cadena El ID de la revisión a la que usted respondió. Se trata de un GUID.
Exitoso cuerda / cadena El valor true indica que la respuesta se envió correctamente. El valor false indica que la respuesta no se realizó correctamente.
Razón de fallo cuerda / cadena Si exitoso es falso, este valor contiene un motivo de la falla. Si correcto es true, este valor está vacío.

Ejemplo de respuesta

En el ejemplo siguiente se muestra un cuerpo de respuesta JSON de ejemplo para esta solicitud.

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