Recurso: Subscription
Modelo JSON de uma assinatura.
Representação JSON |
---|
{ "customerId": string, "subscriptionId": string, "skuId": string, "creationTime": string, "kind": string, "seats": { object ( |
Campos | |
---|---|
customerId |
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. |
subscriptionId |
O |
skuId |
Uma propriedade obrigatória. O |
creationTime |
A propriedade |
kind |
Identifica o recurso como uma assinatura. Valor: |
seats |
Esta é uma propriedade obrigatória. O número e o limite de licenças do usuário no plano. |
renewalSettings |
Configurações de renovação do plano de compromisso anual. Para informações mais detalhadas, consulte as opções de renovação na Central de Ajuda do administrador. |
purchaseOrderId |
Essa propriedade é opcional. Estas informações da ordem de compra (PO, na sigla em inglês) são para os revendedores usarem o acompanhamento da empresa. Se um valor |
status |
Essa propriedade é opcional. |
resourceUiUrl |
URL para a 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 a conclusão de uma tarefa na página "Assinaturas" do Admin Console. |
billingMethod |
Campo somente leitura que retorna o método de faturamento atual de uma assinatura. |
suspensionReasons[] |
Campo somente leitura contendo uma enumeração de todos os motivos atuais de suspensão de uma assinatura. É possível que uma assinatura tenha muitos motivos de suspensão simultâneos e sobrepostos. O
|
customerDomain |
Nome do domínio principal do cliente |
dealCode |
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 em solicitações |
skuName |
Nome de exibição externo somente leitura para um SKU de produto atribuído a um cliente na assinatura. Os nomes das SKUs estão sujeitos a mudanças a critério do Google. Para produtos e SKUs disponíveis nessa versão da API, consulte IDs de produtos e SKUs. |
plan |
A propriedade |
plan.planName |
A propriedade
|
plan.isCommitmentPlan |
O valor booleano da propriedade
|
plan.commitmentInterval |
Nesta versão da API, o intervalo do plano de compromisso anual é de um ano. |
plan.commitmentInterval.startTime |
Um intervalo de compromisso anual ( |
plan.commitmentInterval.endTime |
Um intervalo de compromisso anual ( |
trialSettings |
O compromisso anual do G Suite e os planos de pagamento flexíveis podem ter um teste sem custo financeiro de 30 dias. Para mais informações, consulte os conceitos da API. |
trialSettings.isInTrial |
Determina se o plano de uma assinatura está em um teste sem custo financeiro de 30 dias ou não:
|
trialSettings.trialEndTime |
Data de término do teste. O valor é em milissegundos usando o formato UNIX Époch. Veja um exemplo de conversor de época. |
transferInfo |
Informações relacionadas à transferência somente leitura da assinatura. Para saber mais, consulte Recuperar assinaturas transferíveis para um cliente. |
transferInfo.transferabilityExpirationTime |
O momento em que o token ou a intent da transferência expira. A hora é em milissegundos usando o formato UNIX Époch. |
transferInfo.minimumTransferableSeats |
Ao inserir uma assinatura, esse é o número mínimo de licenças listados no pedido de transferência do produto. Por exemplo, se o cliente tiver 20 usuários, o revendedor não poderá fazer um pedido de transferência de 15 licenças. O mínimo é 20 licenças. |
transferInfo.currentLegacySkuId |
É o |
Lugares
Modelo JSON para licenças de assinatura.
Representação JSON |
---|
{ "numberOfSeats": integer, "maximumNumberOfSeats": integer, "licensedNumberOfSeats": integer, "kind": string } |
Campos | |
---|---|
numberOfSeats |
Esta é uma propriedade obrigatória e exclusiva para assinaturas com planos |
maximumNumberOfSeats |
Esta é uma propriedade obrigatória e exclusiva para assinaturas com planos |
licensedNumberOfSeats |
Campo somente leitura contendo o número atual de usuários que receberam uma licença para o produto definido no |
kind |
Identifica o recurso como uma configuração de licença de assinatura. Valor: |
RenewalSettings
Modelo JSON para uma configuração de renovação de assinatura.
Representação JSON |
---|
{ "renewalType": string, "kind": string } |
Campos | |
---|---|
renewalType |
Configurações de renovação do plano de compromisso anual. Para informações mais detalhadas, consulte as opções de renovação na Central de Ajuda do administrador. Ao renovar uma assinatura, o |
kind |
Identifica o recurso como uma configuração de renovação de assinatura. Valor: |
Métodos |
|
---|---|
|
Ativa uma assinatura previamente suspensa pelo revendedor. |
|
Atualiza um plano de assinatura. |
|
Atualiza as configurações de renovação de uma licença de usuário. |
|
Atualiza as configurações de licença do usuário de uma assinatura. |
|
Cancela, suspende ou transfere uma assinatura para o direto. |
|
Recebe uma assinatura específica. |
|
Cria ou transfere uma assinatura. |
|
Listas de assinaturas gerenciadas pelo revendedor. |
|
Migre imediatamente uma assinatura de teste sem custo financeiro de 30 dias para uma assinatura de serviço pago. |
|
Suspende uma assinatura ativa. |