API de Customer Subscriptions

La API de Customer Subscriptions permite que los administradores recuperen información agregada sobre suscripciones y licencias de un cliente determinado.

Este servicio recupera los detalles de la suscripción a nivel del cliente en diferentes tipos de licencias de ChromeOS:

  • Actualización de Chrome Enterprise (anual): Información sobre las suscripciones recurrentes anuales a la Actualización de Chrome Enterprise, incluidos los recuentos de licencias totales compradas, asignadas y sin asignar, y la fecha de finalización de la suscripción.
  • Actualización de Kiosk & Signage (anual): Información sobre las suscripciones recurrentes anuales a la actualización de Kiosk & Signage, incluidos los recuentos de licencias y la fecha de finalización de la suscripción.
  • Actualización de Chrome Enterprise o Education (perpetua): Información sobre las licencias perpetuas, incluidos los recuentos totales de licencias compradas, asignadas y no asignadas, las licencias retiradas (licencias que se inscribieron en un dispositivo que se retiró y no se pueden transferir) y las licencias disponibles de forma condicional (actualizaciones perpetuas independientes que se desaprovisionaron por motivos de ADP, garantía o reparación que se pueden reutilizar en el mismo modelo de dispositivo).

Descripción general rápida de los métodos de la API

Las URLs son relativas a https://chromemanagement.googleapis.com/v1/customers/{customer_id}

Descripción URL relativa Método HTTP
Obtén información sobre la suscripción y la licencia del cliente /subscriptionInfo GET

Consulta las muestras de código para ver ejemplos de solicitudes y respuestas.

Privilegios de administrador

La API de Customer Subscriptions respeta la delegación de roles de administrador.

Método Se requieren privilegios de administrador
GetSubscriptionInfo "Servicios -> Administración de Chrome -> Administrar dispositivos ChromeOS > Administrar dispositivos ChromeOS (solo lectura)"
o "Servicios -> ChromeOS -> Dispositivos -> Administrar dispositivos -> Leer"

Para administrar los roles y privilegios de administrador, visita "Consola del administrador -> Roles de administrador".

Permisos de la API

La API de Chrome Management Customer Subscriptions requiere el siguiente permiso de OAuth:

https://www.googleapis.com/auth/chrome.management.subscriptions.readonly

Para obtener más información, consulta la Descripción general de la autenticación.