Method: subscriptions.list

Listas de assinaturas gerenciadas pelo revendedor. A lista pode incluir todas as assinaturas, todas as assinaturas de um cliente ou todas as assinaturas transferíveis de um cliente.

Opcionalmente, esse método pode filtrar a resposta por um customerNamePrefix. Para saber mais, consulte Gerenciar assinaturas.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de consulta

Parâmetros
customerAuthToken

string

A string de consulta customerAuthToken é necessária ao criar uma conta de revenda que transfere a assinatura de um cliente direto ou transfere a assinatura de outro cliente de revendedor para seu gerenciamento de revendedor. Esse é um token de autenticação hexadecimal necessário para concluir a transferência da assinatura. Para mais informações, consulte a Central de Ajuda do administrador.
customerId

string

Pode ser o nome de domínio principal ou o identificador exclusivo do cliente. Se o nome de domínio de um cliente mudar, o nome de domínio antigo não poderá ser usado para acessar o cliente, mas o identificador exclusivo do cliente (conforme retornado pela API) poderá sempre ser usado. Recomendamos armazenar o identificador exclusivo nos seus sistemas, quando aplicável.
customerNamePrefix

string

Ao recuperar todas as suas assinaturas e filtrar clientes específicos, você pode inserir um prefixo para o nome de um cliente. Usando um grupo de clientes de exemplo que inclui exam.com, example20.com e example.com:

  • exa: retorna todos os nomes de clientes que começam com "exa" que pode incluir exam.com, example20.com e example.com. O prefixo de nome é semelhante ao uso do asterisco, exa* de uma expressão regular.
  • example: retorna example20.com e example.com.
maxResults

integer (uint32 format)

Ao recuperar uma lista grande, o maxResults é o número máximo de resultados por página. O valor nextPageToken leva você para a próxima página. O padrão é 20.
pageToken

string

Token para especificar a próxima página na lista

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Uma assinatura gerencia a relação do plano de pagamento de um cliente do Google com a SKU de um produto, licenças de usuário, status do teste sem custo financeiro de 30 dias e opções de renovação. A principal função de um revendedor é gerenciar as assinaturas do cliente do Google.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "kind": string,
  "subscriptions": [
    {
      object (Subscription)
    }
  ],
  "nextPageToken": string
}
Campos
kind

string

Identifica o recurso como uma coleção de assinaturas. Valor: reseller#subscriptions
subscriptions[]

object (Subscription)

As inscrições nesta página de resultados.
nextPageToken

string

O token de continuação, usado para percorrer conjuntos grandes de resultados. Forneça esse valor em uma solicitação subsequente para retornar a próxima página de resultados.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte o Guia de autorização.