Enviar respuestas a opiniones

  • Artículo

Importante

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

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 revisión están disponibles en los datos de respuesta del método de obtención de revisiones de aplicaciones en la API de análisis de Microsoft Store y en la descarga sin conexión del informe de revisiones.

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 determinar opcionalmente si tiene permiso para responder a una revisión determinada mediante la información de obtención de la respuesta para el método de revisiones de aplicaciones.

Nota

Además de usar este método para responder mediante programación a las revisiones, también puede responder a las revisiones mediante el Centro de partners.

Requisitos previos

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

  • Si aún no lo ha hecho, complete todos los requisitos previos de la API de revisiones de Microsoft Store.
  • Obtenga un token de acceso de Azure AD para usarlo en el encabezado de solicitud para este método. Una vez que haya obtenido 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 revisión están disponibles en los datos de respuesta del método de obtención de revisiones de aplicaciones en la API de análisis de Microsoft Store y en la descarga sin conexión del informe de revisiones.

Request

Sintaxis de la solicitud

Método URI de solicitud
POST https://manage.devcenter.microsoft.com/v1.0/my/reviews/responses

Encabezado de solicitud

Encabezado Tipo Descripción
Autorización string Necesario. Token de acceso de Azure AD con el formato Token> de portador<.

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.

Valor Tipo Descripción
Respuestas array 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.

Valor Tipo Descripción Obligatorio
ApplicationId string El identificador de la Tienda de la aplicación con la revisión a la que quieres responder. El identificador de la Tienda está disponible en la página Identidad de la aplicación del Centro de partners. Un id. de tienda de ejemplo es 9WZDNCRFJ3Q8. Sí
ReviewId string Identificador de la revisión a la que desea responder (se trata de un GUID). Los identificadores de revisión están disponibles en los datos de respuesta del método de obtención de revisiones de aplicaciones en la API de análisis de Microsoft Store y en la descarga sin conexión del informe de revisiones. Sí
ResponseText string Respuesta que desea enviar. La respuesta debe seguir estas directrices. Sí
SupportEmail string 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 Boolean Si especificas true, la respuesta se mostrará en la descripción de la Tienda de la aplicación, directamente debajo de la revisión del cliente y estará visible para todos los clientes. Si especificas 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 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
    }
  ]
}

Response

Response body

Valor Tipo Descripción
Resultado array 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.

Valor Tipo Descripción
ApplicationId string El identificador de la Tienda de la aplicación con la revisión a la que respondió. Un id. de tienda de ejemplo es 9WZDNCRFJ3Q8.
ReviewId string Identificador de la revisión a la que respondió. Se trata de un GUID.
Correcto string El valor true indica que la respuesta se envió correctamente. El valor false indica que la respuesta no se realizó correctamente.
FailureReason string Si Correcto es false, este valor contiene un motivo para el error. 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"
    }
  ]
}