Method: subscriptions.list

Listas de suscripciones administradas por el revendedor. La lista puede incluir todas las suscripciones, las suscripciones de un cliente o todas las suscripciones transferibles de un cliente.

De manera opcional, este método puede filtrar la respuesta por una customerNamePrefix. Para obtener más información, consulta cómo administrar suscripciones.

Solicitud HTTP

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de consulta

Parámetros
customerAuthToken

string

La cadena de consulta customerAuthToken es obligatoria cuando se crea una cuenta de reventa que transfiere la suscripción de un cliente directo o la suscripción de otro cliente revendedor a tu administración de revendedores. Es un token de autenticación hexadecimal necesario para completar la transferencia de la suscripción. Si quieres obtener más información, consulta el Centro de ayuda para administradores.
customerId

string

Puede ser el nombre de dominio principal del cliente o su identificador único. Si cambia el nombre de dominio de un cliente, no se podrá usar el nombre de dominio anterior para acceder al cliente, pero siempre se podrá usar el identificador único del cliente (como lo muestra la API). Te recomendamos que almacenes el identificador único en tus sistemas cuando corresponda.
customerNamePrefix

string

Cuando recuperes todas tus suscripciones y filtres por clientes específicos, puedes ingresar un prefijo para el nombre de un cliente. Con un grupo de clientes de ejemplo que incluye exam.com, example20.com y example.com:

  • exa: muestra todos los nombres de clientes que comienzan con "exa", lo que podría incluir exam.com, example20.com y example.com. Un prefijo de nombre es similar a usar el asterisco de una expresión regular, exa*.
  • example: muestra example20.com y example.com.
maxResults

integer (uint32 format)

Cuando se recupera una lista grande, maxResults es la cantidad máxima de resultados por página. El valor nextPageToken te lleva a la siguiente página. El valor predeterminado es 20.
pageToken

string

Token para especificar la página siguiente de la lista

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Una suscripción administra la relación del plan de pagos de un cliente de Google con el SKU de un producto, las licencias de usuario, el estado de la prueba gratuita de 30 días y las opciones de renovación. Una de las funciones principales de los revendedores es administrar las suscripciones del cliente de Google.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "kind": string,
  "subscriptions": [
    {
      object (Subscription)
    }
  ],
  "nextPageToken": string
}
Campos
kind

string

Identifica el recurso como una colección de suscripciones. Valor: revendedor#subscriptions
subscriptions[]

object (Subscription)

Las suscripciones que aparecen en esta página de resultados.
nextPageToken

string

Es el token de continuación, que se usa para desplazarse por grandes conjuntos de resultados. Proporciona este valor en una solicitud posterior para mostrar la página siguiente de resultados.

Permisos de autorización

Se necesita uno de los siguientes alcances de OAuth:

  • https://www.googleapis.com/auth/apps.order
  • https://www.googleapis.com/auth/apps.order.readonly

Para obtener más información, consulta la guía de autorización.