REST Resource: subscriptions

string

Essa propriedade sempre será retornada em uma resposta como o identificador exclusivo gerado pelo Google. Em uma solicitação, essa propriedade pode ser o domínio principal ou o identificador exclusivo gerado pelo Google.

string

O subscriptionId é o identificador da assinatura e é exclusivo para cada cliente. Esta é uma propriedade obrigatória. Como um subscriptionId muda quando uma assinatura é atualizada, recomendamos não usar esse ID como uma chave para dados persistentes. Use o subscriptionId conforme descrito em extrair todas as assinaturas de revendedor.

string

Uma propriedade obrigatória. O skuId é um identificador de sistema exclusivo para a SKU de um produto atribuída a um cliente na assinatura. Para saber quais produtos e SKUs estão disponíveis nesta versão da API, consulte IDs de produtos e SKUs.

string (int64 format)

A propriedade creationTime é a data em que a assinatura foi criada. Ele está em milissegundos usando o formato Epoch. Confira um exemplo de conversor de Época.

string

Identifica o recurso como uma assinatura. Valor: reseller#subscription

object (Seats)

Esta é uma propriedade obrigatória. O número e o limite de licenças de usuário no plano.

object (RenewalSettings)

Configurações de renovação do plano de compromisso anual. Para mais detalhes, consulte as opções de renovação na Central de Ajuda para administradores.

string

Essa é uma propriedade opcional. Essas informações de ordem de compra (OC) são para que os revendedores usem no rastreamento da empresa. Se um valor purchaseOrderId for fornecido, ele vai aparecer nas respostas da API e na fatura. A propriedade aceita até 80 caracteres de texto simples.

string

Essa é uma propriedade opcional.

string

URL da página "Assinaturas" do cliente no Admin Console. O URL somente leitura é gerado pelo serviço da API. Isso é usado quando o aplicativo cliente exige que o cliente conclua uma tarefa usando a página "Assinaturas" no Admin Console.

string

Campo somente leitura que retorna o método de faturamento atual de uma assinatura.

string

Campo somente leitura que contém um enumerable de todos os motivos de suspensão atuais de uma assinatura. É possível que uma assinatura tenha vários motivos de suspensão simultâneos e sobrepostos. O STATUS de uma assinatura é SUSPENDED até que todas as suspensões pendentes sejam removidas.

As opções possíveis incluem:

• PENDING_TOS_ACCEPTANCE: o cliente não fez login e aceitou os Termos de Serviço de revenda do G Suite.
• RENEWAL_WITH_TYPE_CANCEL: o compromisso do cliente terminou e o serviço foi cancelado no final do período.
• RESELLER_INITIATED: uma suspensão manual invocada por um revendedor.
• TRIAL_ENDED: o teste do cliente expirou sem um plano selecionado.
• OTHER: o cliente foi suspenso por um motivo interno do Google (por exemplo, abuso ou outro motivo).

string

Nome do domínio principal do cliente

string

Código emitido pelo Google (máximo de 100 caracteres) para preços com desconto em planos de assinatura. O código da oferta precisa ser incluído nas solicitações de insert para receber a tarifa com desconto. Essa propriedade é opcional. Se ela for deixada em branco, o preço normal será aplicado.

string

Nome externo de exibição somente leitura para a SKU de um produto atribuída a um cliente na assinatura. Os nomes de SKU estão sujeitos a mudanças a critério do Google. Para saber quais produtos e SKUs estão disponíveis nesta versão da API, consulte IDs de produtos e SKUs.

object

A propriedade plan é obrigatória. Nesta versão da API, os planos do G Suite são o flexível, o de compromisso anual e o de teste sem custo financeiro de 30 dias. Para mais informações sobre os planos de pagamento da API, consulte os conceitos da API.

string

A propriedade planName é obrigatória. É o nome do plano da assinatura. Para mais informações sobre os planos de pagamento do Google, consulte os conceitos da API.

Os valores possíveis são:

• ANNUAL_MONTHLY_PAY: o plano de compromisso anual com pagamentos mensais.
• ANNUAL_YEARLY_PAY: o plano de compromisso anual com pagamentos anuais
• FLEXIBLE: o plano flexível
• TRIAL: o plano de teste sem custo financeiro de 30 dias. Uma assinatura em teste será suspensa após o 30º dia sem custo financeiro se nenhum plano de pagamento for atribuído. Chamar changePlan vai atribuir um plano de pagamento a um teste, mas não vai ativar o plano. O teste vai começar automaticamente o plano de pagamento atribuído após o 30º dia sem custo financeiro ou imediatamente após a chamada para startPaidService.
• FREE: o plano sem custo financeiro é exclusivo para a SKU do Cloud Identity e não gera faturamento.

boolean

O valor booleano da propriedade isCommitmentPlan identifica o plano como um plano de compromisso anual:

• true: o plano da assinatura é um plano de compromisso anual.
• false: o plano não é de compromisso anual.

object

Nesta versão da API, o intervalo do plano de compromisso anual é de um ano.

string (int64 format)

O startTime do intervalo de um plano de compromisso anual em milissegundos usando o formato de época UNIX. Confira um exemplo de conversor de Época.

string (int64 format)

O endTime do intervalo de um plano de compromisso anual em milissegundos usando o formato de Época UNIX. Confira um exemplo de conversor de Época.

object

O compromisso anual do G Suite e os planos de pagamento flexíveis podem ser usados em um teste sem custo financeiro de 30 dias. Para mais informações, consulte os conceitos de API.

boolean

Determina se o plano de uma assinatura está em um teste sem custo financeiro de 30 dias ou não:

• true: o plano está em teste.
• false: o plano não está em teste.

string (int64 format)

Data em que o teste termina. O valor está em milissegundos usando o formato de época UNIX. Confira um exemplo de conversor de Época.

object

Informações relacionadas à transferência de leitura somente para a assinatura. Para mais informações, consulte Extrair assinaturas transferíveis de um cliente.

string (int64 format)

O horário de expiração do token de transferência ou da intent de transferência. O tempo está em milissegundos usando o formato de época Unix.

integer

Ao inserir uma assinatura, esse é o número mínimo de assentos listados no pedido de transferência para esse produto. Por exemplo, se o cliente tiver 20 usuários, o revendedor não poderá fazer um pedido de transferência de 15 vagas. O mínimo é de 20 lugares.

string

O skuId da assinatura revendida atual. Esse campo é preenchido apenas quando o cliente tem uma assinatura com uma SKU legada e o recurso de assinatura é preenchido com o skuId da SKU recomendada para a transferência.

integer

Essa é uma propriedade obrigatória e exclusiva para assinaturas com planos ANNUAL_MONTHLY_PAY e ANNUAL_YEARLY_PAY. Ela define o número máximo de licenças atribuíveis aos usuários em uma assinatura. O revendedor pode adicionar mais licenças, mas, depois de definido, o numberOfSeats não pode ser reduzido até a renovação. A cobrança do revendedor é baseada no valor de numberOfSeats, independentemente de quantas licenças de usuário são atribuídas.

integer

Essa é uma propriedade obrigatória e exclusiva para assinaturas com planos FLEXIBLE ou TRIAL. Ela define o número máximo de usuários licenciados permitidos em uma assinatura. Essa quantidade pode ser aumentada até o limite máximo definido no contrato do revendedor. A quantidade mínima é o número atual de usuários na conta do cliente.

integer

Campo somente leitura que contém o número atual de usuários atribuídos a uma licença para o produto definido em skuId. O valor desse campo é equivalente à contagem numérica de usuários retornada pelo método da API Enterprise License Manager: listForProductAndSku.

string

Identifica o recurso como uma configuração de assento de assinatura. Valor: subscriptions#seats

string

Configurações de renovação do plano de compromisso anual. Para mais detalhes, consulte as opções de renovação na Central de Ajuda para administradores. Ao renovar uma assinatura, a renewalType é uma propriedade obrigatória.

string

Identifica o recurso como uma configuração de renovação de assinatura. Valor: subscriptions#renewalSettings