Responder a las revisiones mediante los servicios de la Tienda

  • 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 la API de opiniones de Microsoft Store para responder mediante programación a las revisiones de tu aplicación en la Tienda. Esta API es especialmente útil para los desarrolladores que desean responder masivamente a muchas revisiones sin usar el Centro de partners. Esta API usa Azure Active Directory (Azure AD) para autenticar las llamadas desde la aplicación o el servicio.

Los siguientes pasos describen el proceso de principio a fin:

  1. Asegúrese de que ha completado todos los requisitos previos.
  2. Antes de llamar a un método en la API de revisiones de Microsoft Store, obtenga un token de acceso de Azure AD. Después de obtener un token, tienes 60 minutos para usar este token en llamadas a la API de revisiones de Microsoft Store antes de que expire el token. Una vez que expire el token, puede generar un nuevo token.
  3. Llame a la API de opiniones de Microsoft Store.

Nota

Además de usar la API de opiniones de Microsoft Store para responder mediante programación a las revisiones, también puede responder a las revisiones mediante el Centro de partners.

Paso 1: Completar los requisitos previos para usar la API de revisiones de Microsoft Store

Antes de empezar a escribir código para llamar a la API de revisiones de Microsoft Store, asegúrese de que ha completado los siguientes requisitos previos.

  • Usted (o su organización) tiene que tener un directorio de Azure AD y el permiso de Administrador global para el directorio. Si usa Microsoft 365 u otros servicios empresariales de Microsoft, ya tiene el directorio de Azure AD. De lo contrario, puede crear un nuevo Azure AD en el Centro de partners sin ningún cargo adicional.

  • Debe asociar una aplicación de Azure AD a su cuenta del Centro de partners, recuperar el identificador de inquilino y el identificador de cliente de la aplicación y generar una clave. La aplicación de Azure AD representa la aplicación o servicio desde la que quiere llamar a la API de revisiones de Microsoft Store. Necesita el identificador de inquilino, el identificador de cliente y la clave para obtener un token de acceso de Azure AD para pasar a la API.

    Nota

    Solo tiene que realizar esta tarea una vez. Una vez que tenga el identificador de inquilino, el identificador de cliente y la clave, puede volver a usarlos cada vez que tenga que crear un nuevo token de acceso de Azure AD.

Para asociar una aplicación de Azure AD a su cuenta del Centro de partners y recuperar los valores necesarios:

  1. En el Centro de partners, asocie la cuenta del Centro de partners de la organización con el directorio de Azure AD de la organización.

  2. A continuación, en la página Usuarios de la sección Configuración de la cuenta del Centro de partners, agregue la aplicación de Azure AD que representa la aplicación o el servicio que usará para responder a las revisiones. Asegúrese de asignar a esta aplicación el rol Administrador. Si la aplicación aún no existe en el directorio de Azure AD, puede crear una nueva aplicación de Azure AD en el Centro de partners.

  3. Vuelva a la página Usuarios, haga clic en el nombre de la aplicación de Azure AD para ir a la configuración de la aplicación y, a continuación, copie los valores de Identificador de inquilino e Identificador de cliente.

  4. Haga clic en Agregar nueva clave. En la pantalla siguiente, copie el valor de Clave. Después de salir de esta página no podrá tener acceso de nuevo a esta información. Para más información, consulta Administrar claves para una aplicación de Azure AD.

Paso 2: Obtención de un token de acceso de Azure AD

Antes de llamar a cualquiera de los métodos de la API de revisiones de Microsoft Store, primero debe obtener un token de acceso de Azure AD que pase al encabezado Authorization de cada método de la API. 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 actualizar el token para poder seguir utilizándolo en llamadas adicionales a la API.

Para obtener el token de acceso, siga las instrucciones de Service to Service Calls Using Client Credentials (Llamadas de servicio a servicio mediante credenciales de cliente) para enviar un HTTP POST al https://login.microsoftonline.com/<tenant_id>/oauth2/token punto de conexión. Esta es una solicitud de ejemplo.

POST https://login.microsoftonline.com/<tenant_id>/oauth2/token HTTP/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded; charset=utf-8

grant_type=client_credentials
&client_id=<your_client_id>
&client_secret=<your_client_secret>
&resource=https://manage.devcenter.microsoft.com

Para el valor de tenant_id en el URI POST y los parámetros client_id y client_secret , especifique el identificador de inquilino, el identificador de cliente y la clave de la aplicación que recuperó del Centro de partners en la sección anterior. Para el parámetro resource, tiene que especificar https://manage.devcenter.microsoft.com.

Una vez que expire el token de acceso, puede actualizarlo siguiendo las instrucciones que se indican aquí.

Paso 3: Llamar a la API de opiniones de Microsoft Store

Después de tener un token de acceso de Azure AD, está listo para llamar a la API de revisiones de Microsoft Store. Debe pasar el token de acceso al encabezado Authorization de cada método.

La API de opiniones de Microsoft Store contiene varios métodos que puedes usar para determinar si puedes responder a una revisión determinada y enviar respuestas a una o varias revisiones. Siga este proceso para usar esta API:

  1. 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](/windows/apps/publish/reviews-report).
  2. Llame a la información de obtención de respuesta para el método de revisiones de aplicaciones para determinar si tiene permiso para responder a las revisiones. Cuando un cliente envía una revisión, puede optar por no recibir respuestas a su revisión. No puede responder a las revisiones enviadas por los clientes que han elegido no recibir respuestas de revisión.
  3. Llame a las respuestas de envío al método de revisiones de aplicaciones para responder mediante programación a las revisiones.