Recurso: Subscription
Modelo JSON para 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 de usuário no plano. |
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. |
purchaseOrderId |
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 |
status |
Essa é uma propriedade opcional. |
resourceUiUrl |
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. |
billingMethod |
Campo somente leitura que retorna o método de faturamento atual de uma assinatura. |
suspensionReasons[] |
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
|
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 nas solicitações de |
skuName |
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. |
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 |
O |
plan.commitmentInterval.endTime |
O |
trialSettings |
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. |
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 em que o teste termina. O valor está em milissegundos usando o formato de época UNIX. Confira um exemplo de conversor de Época. |
transferInfo |
Informações relacionadas à transferência de leitura somente para a assinatura. Para mais informações, consulte Extrair assinaturas transferíveis de um cliente. |
transferInfo.transferabilityExpirationTime |
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. |
transferInfo.minimumTransferableSeats |
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. |
transferInfo.currentLegacySkuId |
O |
Lugares
Modelo JSON para assentos de assinatura.
Representação JSON |
---|
{ "numberOfSeats": integer, "maximumNumberOfSeats": integer, "licensedNumberOfSeats": integer, "kind": string } |
Campos | |
---|---|
numberOfSeats |
Essa é uma propriedade obrigatória e exclusiva para assinaturas com planos |
maximumNumberOfSeats |
Essa é uma propriedade obrigatória e exclusiva para assinaturas com planos |
licensedNumberOfSeats |
Campo somente leitura que contém o número atual de usuários atribuídos a uma licença para o produto definido em |
kind |
Identifica o recurso como uma configuração de assento de assinatura. Valor: |
RenewalSettings
Modelo JSON para configurações 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 mais detalhes, consulte as opções de renovação na Central de Ajuda para administradores. Ao renovar uma assinatura, a |
kind |
Identifica o recurso como uma configuração de renovação de assinatura. Valor: |
Métodos |
|
---|---|
|
Ativa uma assinatura que foi suspensa pelo revendedor. |
|
Atualiza um plano de assinatura. |
|
Atualiza as configurações de renovação da licença de um usuário. |
|
Atualiza as configurações da licença de usuário de uma assinatura. |
|
Cancela, suspende ou transfere uma assinatura para o Direct. |
|
Recebe uma assinatura específica. |
|
Cria ou transfere uma assinatura. |
|
Listas de assinaturas gerenciadas pelo revendedor. |
|
Mudar imediatamente uma assinatura de teste sem custo financeiro de 30 dias para uma assinatura paga. |
|
Suspende uma assinatura ativa. |