Exportar dados do Channel Services para o BigQuery

Nesta página, mostramos como configurar uma exportação do Channel Services e descrevemos o esquema disponível para uma exportação.

Com o BigQuery, é possível exportar dados de faturamento do Channel Services para um conjunto de dados específico do BigQuery. Esses dados podem ajudar você a realizar uma análise detalhada de como seus clientes ou parceiros de canal estão usando os serviços que você oferece.

As exportações do Channel Services contêm dados específicos do revendedor não incluídos nas exportações do Cloud Billing. Isso inclui custos, créditos e dados de uso com as regras de mudanças de preço configuradas. Essas exportações também agregam todas as informações sobre as contas de faturamento principal dos seus clientes em um único conjunto de dados.

No entanto, os dados de uma exportação do Channel Services são compatíveis com as exportações do Cloud Billing, e é possível usar consultas para mesclar os dois conjuntos de dados para análise.

Para informações sobre exportações do Cloud Billing não revendedores, consulte Como configurar exportações do Cloud Billing para o BigQuery.

Antes de começar

Antes de começar a exportar dados de faturamento do Channel Services, você precisa:

  • Configure um projeto para hospedar seu conjunto de dados do BigQuery. Verifique se o faturamento está ativado no projeto.
  • Ative a API Data Transfer Service do BigQuery no projeto.
  • Criar um conjunto de dados para os dados exportados.

Se você já tiver um projeto e um conjunto de dados do BigQuery para exportações de dados do Cloud Billing, eles poderão ser reutilizados para a exportação do Channel Services.

Para informações detalhadas sobre como configurar um projeto e um conjunto de dados, consulte Configurar a exportação de dados do Cloud Billing para o BigQuery.

Permissões necessárias para exportações

Para ativar e configurar as exportações do Channel Services, você precisa ter os seguintes papéis:

Selecionar um projeto e um conjunto de dados

No Partner Sales Console, selecione um projeto e um conjunto de dados no BigQuery para armazenar os dados do Channel Services. Ative o faturamento no projeto, caso ainda não esteja ativado.

Ao selecionar ou criar um conjunto de dados do BigQuery, você pode escolher um dos locais compatíveis com o BigQuery para o conjunto. Quando você ativa a exportação de dados do Channel Services pela primeira vez por fonte de dados (Google Cloud ou Google Workspace):

  • Se você configurar o conjunto de dados do BigQuery para usar um local multirregional, os dados de exportação do BigQuery ficarão disponíveis para cada fonte de dados selecionada desde o início do mês anterior. Por exemplo, se você ativar o BigQuery Export em 23 de setembro, sua exportação incluirá dados a partir de 1o de agosto.

  • Se você configurar o conjunto de dados do BigQuery para usar um local de região (que não seja multirregional US ou EU), os dados de exportação do BigQuery estarão disponíveis para cada fonte de dados selecionada a partir da data em que você ativar a exportação. Ou seja, os dados do BigQuery Export não são adicionados retroativamente para locais do conjunto de dados que não sejam de várias regiões. Portanto, você não verá os dados do BigQuery Export antes de ativar a exportação.

Para exportar dados de faturamento de várias contas do Partner Sales Console, siga estas etapas:

  1. No conjunto de dados do BigQuery para onde você quer exportar seus dados, verifique se os administradores de faturamento de cada conta do Partner Sales Console têm permissões para visualizá-lo.
  2. Ao configurar a exportação de dados de faturamento em cada conta do Partner Sales Console, selecione o conjunto de dados unificado.

Locais compatíveis do BigQuery

Locais multirregionais

A tabela a seguir lista as multirregiões em que a exportação de dados do BigQuery do Channel Services é compatível.

Descrição multirregional Nome multirregional
Data centers dentro de estados membro da União Europeia1 EU
Data centers nos Estados Unidos US

Regiões

A tabela a seguir lista as regiões nas Américas com suporte para a exportação de dados do BigQuery do Channel Services.

Descrição da região Nome da região
Iowa us-central1
Las Vegas us-west4
Los Angeles us-west2
Montreal northamerica-northeast1
Virgínia do Norte us-east4
Oregon us-west1
Salt Lake City us-west3
São Paulo southamerica-east1
Carolina do Sul us-east1

A tabela a seguir lista as regiões na Ásia-Pacífico que recebem suporte para a exportação de dados do BigQuery do Channel Services.

Descrição da região Nome da região
Hong Kong asia-east2
Jacarta asia-southeast2
Mumbai asia-south1
Osaka asia-northeast2
Seul asia-northeast3
Singapura asia-southeast1
Sydney australia-southeast1
Taiwan asia-east1
Tóquio asia-northeast1

A tabela a seguir lista as regiões da Europa em que a exportação de dados do BigQuery do Channel Services é compatível.

Descrição da região Nome da região
Bélgica europe-west1
Finlândia europe-north1
Frankfurt europe-west3
Londres europe-west2
Países Baixos europe-west4
Varsóvia europe-central2
Zurique europe-west6

Ativar a exportação

Antes de ativar a exportação de dados, anote o ID do conjunto de dados totalmente qualificado, que está no formato PROJECT_ID:DATASET_NAME.

Para ativar a exportação do Channel Services:

  1. No Partner Sales Console, abra a página Faturamento.
  2. Selecione Exportação de faturamento.
  3. Insira o ID do conjunto de dados totalmente qualificado no campo Conjunto de dados de refaturamento.
  4. Selecione as Fontes de dados que você quer exportar.
  5. Clique em Atualizar. Se for exibida uma solicitação para atualizar as permissões do conjunto de dados, clique em Atualizar.

UI para ativar exportações de refaturamento

Após a configuração, a exportação de faturamento vai fornecer dados de uso incrementais diariamente. A tabela de exportação não será exibida até que a exportação de faturamento seja executada na sua conta pela primeira vez. O conjunto de dados contém dados de quando foi configurado pela primeira vez para reter dados.

Para interromper a exportação dos dados de custo de refaturamento para o conjunto de dados, clique em Desativar a exportação de dados de faturamento na página Refaturamento do cliente. Para reativar a exportação, siga as etapas anteriores para especificar um ID de conjunto de dados.

Os dados de custo de refaturamento podem ficar indisponíveis durante o período em que estiver desativado. Se você excluir os dados exportados durante esse período, não poderemos adicionar retroativamente os registros excluídos.

Permissões necessárias da conta de serviço

A exportação de dados do Channel Services usa uma conta de serviço que pertence e é gerenciada pelo Google e tem permissão para gravar registros de faturamento em uma tabela. A conta de serviço é:

cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com

Esta conta de serviço requer o papel predefinido: roles/bigquery.dataEditor para permitir exportações. É possível configurar as permissões seguindo as etapas para ativar a exportação.

Consulte dados com eficiência

A tabela do BigQuery é particionada por export_time e agrupada por payer_billing_account_id por padrão. Isso significa que a tabela é dividida em partições menores, cada uma sendo dividida ainda mais em clusters menores. Usar as chaves de partição e cluster em uma consulta ajuda o BigQuery a localizar rapidamente os dados relevantes, o que pode reduzir significativamente o custo da consulta.

Por exemplo, a consulta abaixo é eficiente se comparada a uma sem chaves de particionamento e clustering:

SELECT
  billing_account_id
  currency,
  invoice.month,
  -- Divide by currency_conversion_rate if converting non-USD to USD.
  SUM(cost)
    + SUM(
      IFNULL(
        (SELECT SUM(c.amount) FROM UNNEST(credits) AS c), 0))
    AS total
FROM PROJECT_ID.DATASET_NAME.reseller_billing_detailed_export_v1
WHERE
  export_time BETWEEN TIMESTAMP(START_DATE)
    AND TIMESTAMP(END_DATE)
  AND payer_billing_account_id IN (PAYER_BILLING_ACCOUNT_IDS)
GROUP BY
  billing_account_id,
  currency,
  invoice.month
ORDER BY
  billing_account_id,
  currency,
  invoice.month;

Para mais informações sobre particionamento, clustering e práticas recomendadas, consulte os seguintes links:

  1. Consultar tabelas particionadas
  2. Consultar tabelas em cluster
  3. Otimizar a computação em consultas
  4. Práticas recomendadas para controlar custos no BigQuery

Encontrar o ID da conta de faturamento do pagador

Para encontrar o ID da conta de faturamento do pagador, abra a página de contas de faturamento do Partner Sales Console e clique na guia Faturamento do parceiro.

É possível consultar todas as contas de faturamento e os IDs das contas de faturamento do pagador.

ID da conta de faturamento do pagador

Configurar controles de acesso para outros usuários no conjunto de dados de exportação

Há várias maneiras de configurar controles de acesso nos dados no BigQuery Export. Para mais informações, consulte os controles de acesso do BigQuery.

Para garantir que os usuários tenham acesso apenas aos dados que estão autorizados a ver, recomendamos configurar visualizações autorizadas para compartilhar dados do conjunto de dados exportado.

Ao configurar permissões para usuários, verifique se a conta de serviço cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com sempre tem acesso total de editor no conjunto de dados para exportação contínua de dados.

Esquema de tabela

O esquema a seguir descreve os dados na tabela do BigQuery.

No conjunto de dados do BigQuery, a exportação detalhada de refaturamento é carregada em uma tabela de dados chamada reseller_billing_detailed_export_v1.

Campo Tipo Descrição
billing_account_id String O ID da conta a que o uso está associado, que pode ser seu ou do cliente. Dependendo da família de produtos, pode ser uma conta de faturamento ou um ID do Cloud Identity.
payer_billing_account_id String O ID da sua conta de faturamento principal.
invoice.month String Mostra o ano e o mês (AAAAMM) da fatura que inclui os itens de linha de custo. Por exemplo: "202101" é o mesmo que janeiro de 2021.
cost_type String O tipo de custo representado por este item de linha: regular, tributos, ajuste ou erro de arredondamento.
service.id String O código do serviço que está associado ao uso.
service.description String Mostra o Serviço do Google que informou os dados de faturamento.
sku.id String Mostra o ID da SKU do recurso usado pelo serviço.
sku.description String Uma descrição do tipo de recurso usado pelo serviço. Por exemplo, o Cloud Storage é do tipo Standard Storage US.
usage_start_time Carimbo de data/hora O horário de início da janela de uso por hora do custo calculado. O uso e os custos de todos os serviços são exibidos com granularidade por hora. O uso do serviço de longa duração é distribuído em várias janelas de hora em hora. Para produtos por assinatura, este é o início do mês de faturamento.
usage_end_time Carimbo de data/hora O horário de término da janela de uso por hora do custo calculado. O uso e os custos de todos os serviços são exibidos com granularidade por hora. O uso do serviço de longa duração é distribuído em várias janelas de hora em hora. Para produtos por assinatura, este é o fim do mês de faturamento.
project Struct Informações sobre o projeto do Google Cloud que gerou os dados do Cloud Billing.
project.number String Um identificador gerado internamente, anônimo e exclusivo para o projeto do Google Cloud que gerou os dados do Cloud Billing.
project.id String O ID do projeto do Google Cloud que gerou os dados do Cloud Billing.
project.name String Mostra o nome do projeto do Google Cloud que gerou os dados do Cloud Billing.
project.labels Estrutura, repetido
project.labels.key String Se rótulos estiverem presentes, a parte key do par de chave-valor.
project.labels.value String Se rótulos estiverem presentes, a parte valor do par de chave-valor.
project.ancestry_numbers String Os ancestrais da hierarquia de recursos do projeto identificado pelo project.id.
labels Estrutura, repetido
labels.key String Se rótulos estiverem presentes, a parte key do par de chave-valor.
labels.value String Se rótulos estiverem presentes, a parte valor do par de chave-valor.
system_labels Estrutura, repetido
system_labels.key String Se os rótulos do sistema estiverem presentes, a parte key do par de chave-valor.
system_labels.value String Se os rótulos do sistema estiverem presentes, a parte valor do par de chave-valor.
location.location String Localização do uso no nível de um país, região ou zona. Mostra global para recursos sem local específico. Para mais informações, consulte Regiões e zonas.
location.country String Quando location.location é um país, uma região ou uma zona, este campo é o país de uso. Por exemplo, US. Para mais informações, consulte Regiões e zonas.
location.region String Quando location.location é um país ou uma região, este campo é a região de uso. Por exemplo, us-central1. Para mais informações, consulte Regiões e zonas.
location.zone String Quando location.location é uma zona, esse campo é a zona de uso. Por exemplo, us-central1-a. Para mais informações, consulte Regiões e zonas.
resource Struct Descreve a estrutura e o valor das informações relevantes para recursos de serviço (por exemplo, máquinas virtuais ou um SSD) que geram uso de serviço.
resource.name String Um identificador específico do serviço para o recurso que gerou o uso relevante. Podem ser gerados pelo usuário.
resource.global_name String Um identificador de serviço globalmente exclusivo para o recurso que gerou o uso relevante.
cost Numérico Custo de uso antes dos créditos aplicados. Para conferir o custo total, incluindo os créditos, adicione credits.amount a cost.
currency String A moeda de faturamento do custo. Para mais informações, consulte Moeda local para faturamento e pagamentos.
currency_conversion_rate Float A taxa de câmbio de dólares americanos para a moeda local. Ou seja, cost ÷ currency_conversion_rate é igual ao custo em dólares americanos.
usage.amount Numérico A quantidade de usage.unit usada.
usage.unit String A unidade base para medir o uso de recursos. Por exemplo, a unidade base para armazenamento padrão é byte-segundos.
usage.amount_in_pricing_unit Numérico A quantidade de uso do usage.pricing_unit.
usage.pricing_unit String As unidades para medir o uso de recursos.
credits Estrutura, repetido Contém campos que descrevem a estrutura e o valor dos créditos.
credits.id String Se preenchido, indica que um crédito está associado à SKU do produto.
credits.full_name String O nome do crédito associado à SKU do produto.
credits.type String Este campo descreve a finalidade ou a origem do credits.id.
credits.name String Uma descrição do crédito aplicado ao uso.
credits.amount Numérico Valor do crédito aplicado ao uso.
credits.channel_partner_amount Numérico O valor do crédito aplicado ao uso, após descontos e marcações de refaturamento. Com base na channel_partner_name e na ChannelPartnerRepricingConfig associada. Se credits.type for RESELLER_MARGIN, esse valor será zero.
credits.customer_amount Numérico O valor do crédito aplicado ao uso, após descontos e marcações de refaturamento. Com base na customer_name e na CustomerRepricingConfig associada. Se credits.type for RESELLER_MARGIN, esse valor será zero.
adjustmentsInfo Estrutura, repetido Contém campos que descrevem a estrutura e o valor de um ajuste para itens de linha de custo.
adjustmentsInfo.adjustment_id String Se preenchido, um ajuste será associado a um item de linha de custo. adjustmentsInfo.adjustments_id é o ID exclusivo de todos os ajustes causados por um problema.
adjustmentsInfo.adjustment_description String A descrição do ajuste e a causa.
adjustmentsInfo.adjustment_type String O tipo do ajuste.
adjustmentsInfo.adjustment_mode String Mostra como o ajuste foi emitido.
export_time Carimbo de data/hora Mostra um tempo de processamento associado a um anexo de dados de faturamento. Ele sempre aumentará a cada nova exportação. Use a coluna export_time para entender quando os dados de faturamento exportados foram atualizados pela última vez.
entitlement_name String O nome do recurso do Entitlement da API Cloud Channel. Usa o formato: accounts/{account}/customers/{customer}/entitlements/{entitlement}
channel_partner_name String (Apenas distribuidores) O nome do recurso do parceiro de canal que vende para o cliente final. Usa o formato: accounts/{account}/channelPartnerLinks/{channelPartner}.
channel_partner_cost Numérico (Apenas distribuidores) O custo para o parceiro de canal, identificado por channel_partner_name, após a aplicação de um ChannelPartnerRepricingConfig.
customer_name String O nome do recurso do cliente do revendedor que consumiu esse uso no formato accounts/{account}/customers/{customer}
customer_cost Numérico O custo para o cliente do revendedor identificado na coluna customer_name após a aplicação de CustomerRepricingConfig, se houver.
cost_at_list Numérico O custo se cobrado com preços públicos.
customer_repricing_config_name String O nome do recurso da API Cloud Channel CustomerRepricingConfig. Usa o formato: accounts/{account}/customers/{customer}/customerRepricingConfigs/{id}.
channel_partner_repricing_config_name String (Apenas distribuidores) O nome do recurso da API Cloud Channel ChannelPartnerRepricingConfig. Usa o formato: accounts/{account}/channelPartnerLinks/{channelPartner}/channelPartnerRepricingConfigs/{id}.
tags Struct Campos que descrevem a tag, como chave, valor e namespace.
tags.key String É o nome curto ou de exibição da chave associada a essa tag específica.
tags.value String Os recursos anexados a uma chave de tag. A qualquer momento, exatamente um valor pode ser anexado a um recurso para uma determinada chave.
tags.inherited Booleano Indica se uma vinculação de tags é herdada (Tags herdadas = Verdadeiro) ou direta/não herdada (Tags herdadas = Falso).
tags.namespace String Representa a hierarquia de recursos que define valores e chaves de tags. O namespace pode ser combinado com nomes curtos de chave e valor de tag para criar um nome globalmente exclusivo e totalmente qualificado para a chave ou o valor da tag.
customer_correlation_id String O ID externo do CRM do cliente. Preenchido apenas se existir um ID de CRM para esse cliente.
price Struct Campos que descrevem a estrutura e o valor relacionados aos preços cobrados pelo uso.
price.effective_price Numérico O preço cobrado pelo uso.
price.tier_start_amount Numérico O número limite de unidades para a camada de preços de uma SKU. Por exemplo, uma SKU com três níveis de preços, como de 0 a 100 unidades, de 101 a 1.000 unidades e mais de 1.001 unidades, vai mostrar três linhas de preços para a SKU, com 0, 101 e 1.001 no campo price.tier_start_amount representando a quantidade de unidades inicial dos níveis de preço da SKU. Saiba mais sobre os níveis de preços do Google Cloud.
price.unit String A unidade de uso em que o preço é especificado e o uso de recursos é medido, como gibibyte, tebibyte, mês, ano, gibibyte/hora, gibibyte/mês ou contagem. O valor no campo price.unit corresponde ao valor no campo usage.pricing_unit.
price.pricing_unit_quantity Numérico A quantidade da unidade do nível do preço da SKU. Por exemplo, se o preço do nível for US $1 por 1000.000 bytes, essa coluna mostrará 1000000.
transaction_type String O tipo de transação do vendedor. O tipo de transação pode ser um dos seguintes:
  • GOOGLE = 1: serviços vendidos pelo Google Cloud.
  • THIRD_PARTY_RESELLER = 2: serviços de terceiros revendidos pelo Google Cloud.
  • THIRD_PARTY_AGENCY = 3: serviços de terceiros vendidos por um parceiro, com o Google Cloud atuando como agente.
seller_name String A razão social do vendedor.
subscription Struct Campos que descrevem seus compromissos baseados em gastos ou em recursos. É possível usar esses campos para analisar as taxas de compromissos específicos.
subscription.instance_id String O ID da assinatura vinculado a um compromisso.

Observações adicionais sobre o esquema

Colunas não aplicáveis ao Google Workspace

Quando uma coluna ou um campo não se aplicar a uma família de produtos, os dados exportados para ela conterão null nessa coluna/campo. As colunas/campos a seguir não se aplicam às exportações do Google Workspace:

  • project
  • labels
  • resource
  • credits
  • adjustmentsInfo
  • cost_at_list
  • customer_repricing_config_name
  • channel_partner_repricing_config_name
  • tags
  • price.effective_price
  • price.tier_start_amount
  • transaction_type
  • seller_name

Outras observações sobre a exportação do Google Workspace

Há vários comportamentos especiais nas exportações do Google Workspace:

  • Os dados do Google Workspace não incluem o uso do revendedor.
  • Quando cost_type for tax e adjustment, usage.amount_in_pricing_units será sempre 1.
  • Nas faturas do Google Workspace, os tributos são mostrados como um item de linha. Na exportação, os tributos são detalhados por cliente. Embora o tributo total corresponda à fatura, os tributos individuais podem conter pequenas imprecisões no arredondamento.

billing_account_id

  • Para o Google Cloud, essa é a conta do Cloud Billing a que o uso está associado.
  • Para o Google Workspace, esse é o ID do Cloud Identity do cliente.

service e sku

Para o Google Workspace, essas colunas representam o "Produto" e a "SKU" associados ao uso. Saiba mais sobre IDs de produtos e SKUs.

usage_start_time e usage_end_time

No CSV da fatura do Google Workspace, isso é representado como datas. Nas exportações, eles são representados como carimbos de data/hora:

  • Para usage_start_time, esse é o horário de início (inclusive) da assinatura, às 0h00 PST na data de início.
  • Para usage_end_time, esse é o horário de término (exclusivo) da assinatura, às 0h (PST) do dia posterior à data de término.

project.labels

Para o Google Cloud, esses são os pares de chave-valor no projeto do Google Cloud em que ocorreu o uso. Para mais informações, consulte Como usar rótulos.

labels

Para o Google Cloud, esses são os pares de chave-valor no recurso do Google Cloud em que ocorreu o uso. Para mais informações, consulte Como usar rótulos.

system_labels

  • Para o Google Cloud, esses são os pares de chave-valor no recurso do Google Cloud em que ocorreu o uso. Para mais informações, consulte Rótulos do sistema disponíveis.

  • Para o Google Workspace, esses são outros metadados sobre o custo, que incluem:

    • workspace.googleapis.com/domain_name: o nome de domínio do cliente.
    • workspace.googleapis.com/order_id: o ID do pedido.
    • workspace.googleapis.com/purchase_order_id: o ID da ordem de compra (PO, na sigla em inglês).
    • workspace.googleapis.com/subscription_id: o ID da assinatura.
    • workspace.googleapis.com/usage_type: o tipo de uso. Não se aplica se cost_type não for regular.

Os tipos de uso do Google Workspace incluem:

  • COMMITMENT_TERM_START_ITEM: início de uma assinatura. Geralmente associado a um mês parcial para uma assinatura de compromisso mensal faturada e ao período de faturamento/contrato para uma assinatura pré-paga.
  • COMMITMENT_TERM_END_ITEM: fim da assinatura. Normalmente associada às cobranças do último mês de uma assinatura de compromisso faturada mensal.
  • COMMITMENT_TERM_RENEWAL_ITEM: início de um período de assinatura subsequente.
  • COMMITMENT_MONTHLY_ITEM: uso registrado para compromissos atuais no início do mês. Na maioria dos casos, a cobrança se estenderá durante todo o mês.
  • COMMITMENT_SEATS_CHANGE_ITEM: registrado quando o nível de compromisso muda (aumento ou diminuição). Geralmente começa no meio do mês e se estende até o final do mês para uma assinatura de compromisso mensal faturada ou até o final do período de faturamento/contrato de uma assinatura pré-paga.
  • COMMITMENT_CANCEL_ITEM: registrado quando uma assinatura é cancelada. Inclui cobranças associadas ao encerramento antecipado. Representa uma cobrança pelo restante do período do contrato quando o contrato é cancelado na metade do período de faturamento ou um crédito emitido pelo restante do período de faturamento quando um contratado é alterado ou cancelado no meio do processo.
  • FLEXIBLE_SEATS_ITEM: registra o uso de para algum número de usuários em um bloco contíguo de um número de dias. Atualmente, destinado apenas a usuários sem compromisso.
  • COUPON_DISCOUNT_ITEM: valor do desconto associado a um cupom.
  • MIGRATED_CREDIT_ITEM: crédito da migração do Pub/Sub.
  • COMMITMENT_PREPAY_BILLING_PERIOD_ITEM: representa uma informação de uso criada no início do ciclo de pagamento para todo o ciclo de uma assinatura de pré-pagamento de compromisso.

usage.amount

Para o uso baseado em licenças do Google Workspace, isso indica licenças pagas. Por exemplo, licenças contratadas para compromissos ou número de licenças pagas flexíveis.

usage.pricing_unit

credits.id

Para o Google Cloud, é um identificador alfanumérico exclusivo (12-b34-c56-d78) ou uma descrição do tipo de crédito (Desconto por uso contínuo: CPU ). Se o campo credits.id estiver vazio, a SKU do produto não estará associada a um crédito.

credits.full_name

Para o Google Cloud, essa é uma descrição legível de um credits.id alfanumérico. Os exemplos incluem Crédito do teste sem custo financeiro ou Desconto por compromisso de uso com base em gastos . Os valores credits.full_name são preenchidos apenas para SKUs com um credits.id alfanumérico. Se o valor de credits.id for uma descrição do tipo de crédito (como Desconto por compromisso de uso: CPU), o campo credits.full_name estará vazio.

credits.type

Para o Google Cloud, os tipos de crédito incluem:

  • COMMITTED_USAGE_DISCOUNT: contratos de uso contínuo com base em recursos comprados para o Compute Engine em retorno para preços com grandes descontos para o uso da VM.
  • COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE : contratos de uso contínuo com base em gastos comprados para serviços em troca do seu compromisso de gastar uma quantia mínima.
  • DISCOUNT: o tipo de crédito de desconto é usado para créditos recebidos após um limite de gasto contratual ser atingido. Nos relatórios do Cloud Billing disponíveis no Partner Sales Console, o tipo de crédito de desconto está listado como Descontos com base nos gastos (contratual).
  • FREE_TIER: alguns serviços oferecem uso gratuito de recursos até os limites especificados. Nesses serviços, os créditos são aplicados para implementar o uso de nível gratuito.
  • PROMOTION: o tipo de crédito promocional inclui o teste gratuito do Google Cloud e créditos de campanhas de marketing ou outros benefícios para usar o Google Cloud. Quando disponíveis, os créditos promocionais são considerados uma forma de pagamento e são aplicados automaticamente para reduzir o total da fatura.
  • RESELLER_MARGIN: se você for um revendedor, o tipo de crédito de margem do revendedor indica os descontos do programa para revendedores recebidos em cada item de linha qualificado.
  • SUBSCRIPTION_BENEFIT: créditos recebidos pela compra de assinaturas de longo prazo de serviços em troca de descontos.
  • SUSTAINED_USAGE_DISCOUNT: o tipo de crédito de descontos por uso prolongado é um desconto automático que você ganha ao executar recursos específicos do Compute Engine por uma parte significativa do mês de faturamento.

adjustmentsInfo

Para o Google Cloud, esses valores só serão preenchidos se o item de linha de custo tiver sido gerado para uma modificação do Cloud Billing. O tipo adjustmentsInfo contém detalhes sobre o ajuste, se ele foi emitido para corrigir um erro ou por outros motivos.

adjustmentsInfo.adjustment_type

Para o Google Cloud, isso inclui:

  • USAGE_CORRECTION: uma correção devido a um uso incorreto informado.
  • PRICE_CORRECTION: uma correção devido a regras de precificação incorretas.
  • METADATA_CORRECTION: uma correção para corrigir metadados sem mudar o custo.
  • GOODWILL: um crédito emitido para o cliente pela reputação.
  • SALES_BASED_GOODWILL: um crédito emitido para o cliente por mais-valia, como parte de um contrato.
  • SLA_VIOLATION: um crédito emitido para o cliente devido a uma violação do objetivo de nível de serviço (SLO).
  • BALANCE_TRANSFER: um ajuste para transferir fundos de uma conta para pagamentos para outra.
  • ACCOUNT_CLOSURE: um ajuste para zerar uma conta encerrada.
  • GENERAL_ADJUSTMENT: uma modificação geral da conta de faturamento.

adjustmentsInfo.adjustment_mode

Para o Google Cloud, isso inclui:

  • PARTIAL_CORRECTION: a correção nega parcialmente o uso e o custo originais.
  • COMPLETE_NEGATION_WITH_REMONETIZATION: a correção nega totalmente o uso e o custo originais e emite os itens de linha corrigidos com o uso e o custo atualizados.
  • COMPLETE_NEGATION: a correção nega totalmente o uso e o custo originais, e nenhum outro uso é monetizado novamente.
  • MANUAL_ADJUSTMENT: o ajuste é alocado ao custo e ao uso manualmente.

price.effective_price

Para o Google Cloud, esse é o preço cobrado pelo uso das SKUs do Google Cloud ou da Plataforma Google Maps e das faixas de preços das SKUs. Se a conta do Cloud Billing tiver preços de contrato personalizados, esse será o preço específico da conta de faturamento. Caso contrário, este será o preço de tabela da SKU ou do nível de SKU.