Exportar dados do Channel Services para o BigQuery

Nesta página, mostramos como configurar uma exportação do Channel Services, além de descrever 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 do BigQuery especificado. 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ê fornece.

As exportações do Channel Services contêm dados específicos do revendedor que não estão incluídos nas exportações do Cloud Billing. Isso inclui custos, créditos e dados de uso com as regras de substituição 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 do serviço de transferência de dados do BigQuery no projeto.
  • Crie um conjunto de dados para os dados exportados.

Se você já tiver um projeto e um conjunto de dados do BigQuery para as exportações de dados do Cloud Billing, será possível reutilizar esse projeto e o conjunto de dados 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, escolha um dos locais compatíveis do BigQuery para ele. 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 da exportação do BigQuery estarã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, a exportação incluirá dados a partir de 1o de agosto.

  • Se você configurar o conjunto de dados do BigQuery para usar um local regional (que não seja multirregional EUA ou UE), 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 de conjuntos de dados não multirregionais. 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 os dados, verifique se os administradores de faturamento de cada conta do Partner Sales Console têm permissões para visualizar o conjunto de dados.
  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 com o BigQuery

Locais multirregionais

Na tabela a seguir, listamos as multirregiões em que a exportação de dados do BigQuery do Channel Services é aceita.

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

Regiões

Na tabela a seguir, listamos as regiões nas Américas em que a exportação de dados do BigQuery do Channel Services é compatível.

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

Na tabela a seguir, listamos as regiões da Ásia-Pacífico em que a exportação de dados do BigQuery do Channel Services é compatível.

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

Na tabela a seguir, listamos as regiões na 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 para exportar os dados.
  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 mostrar 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 do conjunto de dados.

Os dados de custo de refaturamento podem ficar indisponíveis durante esse período. Se você excluir 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 em cluster por payer_billing_account_id por padrão. Isso significa que a tabela é dividida em partições menores, cada uma delas dividida em clusters menores. Usar as chaves de partição e de cluster em uma consulta ajudará o BigQuery a localizar rapidamente os dados relevantes, o que pode reduzir significativamente o custo da consulta.

Por exemplo, a consulta abaixo é eficiente em comparação a uma sem particionamento e clustering de chaves:

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

Como 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 Partner Billing.

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

ID da conta de faturamento do pagador

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

Há várias maneiras de configurar controles de acesso aos dados na exportação do BigQuery. 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 visualizar, recomendamos configurar Visualizações autorizadas para compartilhar dados do seu 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 de dados contínua.

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. Ele 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 EUA.
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 mostrados com granularidade por hora. O uso de serviços 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 mostrados com granularidade por hora. O uso de serviços 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 exclusivo, anônimo e gerado internamente 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 houver rótulos, 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 houver rótulos, a parte valor do par de chave-valor.
system_labels Estrutura, repetido
system_labels.key String Se houver rótulos do sistema, a parte key do par de chave-valor.
system_labels.value String Se houver rótulos do sistema, 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 for um país, região ou zona, este campo será o país de uso. Por exemplo, US. Para mais informações, consulte Regiões e zonas.
location.region String Quando location.location for um país ou uma região, este campo será a região de uso. Por exemplo, us-central1. Para mais informações, consulte Regiões e zonas.
location.zone String Quando location.location for uma zona, esse campo será 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 os recursos de serviço (por exemplo, máquinas virtuais ou um SSD) que geram o uso do serviço.
resource.name String Um identificador específico do serviço para o recurso que gerou o uso relevante. Podem ser geradas 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 O custo de uso antes de qualquer crédito aplicado. Para acessar 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 Ponto flutuante 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 de 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 a refaturamento das marcações e dos descontos. Com base no channel_partner_name e no ChannelPartnerRepricingConfig associado. Se credits.type for REvendor_MARGIN, esse valor será zero.
credits.customer_amount Numérico O valor do crédito aplicado ao uso, após a refaturamento das marcações e dos descontos. Com base no customer_name e no CustomerRepricingConfig associado. Se credits.type for REvendor_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 (Somente distribuidores) O nome de recurso do parceiro de canal que está vendendo para o cliente final. Usa o formato: accounts/{account}/channelPartnerLinks/{channelPartner}.
channel_partner_cost Numérico (Somente distribuidores) O custo para o parceiro de canal, identificado por channel_partner_name, após a aplicação de um ChannelPartnerRepricingConfig.
customer_name String Mostra o nome do recurso do cliente do revendedor que consumiu esse uso no formato accounts/{account}/customers/{customer}.
customer_cost Numérico Mostra 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 base em 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 (Somente 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 tag é 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 totalmente qualificado e exclusivo globalmente para a chave ou o valor de tag.
customer_correlation_id String O ID do CRM externo do cliente. Preenchido apenas se houver 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, exibirá três linhas de preços para a SKU, com 0, 101 e 1001 no campo price.tier_start_amount, representando a quantidade da unidade inicial dos níveis de preços 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 de US $1 por 1000000 bytes, a 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 terceirizados 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.

Outras observações sobre o esquema

Colunas não aplicáveis ao Google Workspace

Quando uma coluna ou um campo não se aplica a uma família de produtos, os dados exportados para essa família contêm null nessa coluna/campo. Os seguintes campos/colunas 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 contêm informações de uso do revendedor.
  • Quando cost_type é tax e adjustment, usage.amount_in_pricing_units é 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 total de tributos deva corresponder à 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

No 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 (inclusivo) da assinatura, às 0h00 PST na data de início.
  • Para usage_end_time, esse é o horário de término (exclusivo) da assinatura, à 0h00 PST no dia após a 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 de sistema disponíveis.

  • Para o Google Workspace, estes são os metadados adicionais 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 aplicável se cost_type não for regular.

Os tipos de uso do Google Workspace incluem:

  • COMMITMENT_TERM_START_ITEM: início de uma assinatura. Normalmente, associado a um mês parcial para uma assinatura de compromisso faturada mensalmente e para o período de faturamento/contrato de uma assinatura pré-paga.
  • COMMITMENT_TERM_END_ITEM: fim de uma assinatura. Normalmente, associada às cobranças do último mês de uma assinatura de compromisso faturada mensalmente.
  • COMMITMENT_TERM_RENEWAL_ITEM: início do período de assinatura posterior.
  • COMMITMENT_MONTHLY_ITEM: uso registrado para compromissos existentes 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 é alterado (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 faturada mensalmente ou até o final do período de faturamento/contrato de uma assinatura pré-paga.
  • COMMITMENT_CANCEL_ITEM: gravado quando uma assinatura é cancelada. Inclui cobranças associadas ao encerramento antecipado. Representa uma cobrança para o restante do período do contrato, quando o contrato é cancelado no meio do caminho, ou um crédito emitido para o restante do período de faturamento, quando um contrato é alterado ou cancelado no meio do caminho.
  • FLEXIBLE_SEATS_ITEM: registra o uso por para um determinado número de usuários para um bloco contíguo de determinado 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 Migrate.
  • 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 com compromisso.

usage.amount

No caso do uso de licenças do Google Workspace, isso indica as licenças pagas. Por exemplo, licenças contratadas para compromissos ou número de licenças pagas por assinatura flexível.

usage.pricing_unit

credits.id

Para o Google Cloud, isso é um identificador alfanumérico exclusivo (12-b34-c56-d78) ou uma descrição do tipo de crédito (Desconto por compromisso de uso: 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 de teste gratuito 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

No Google Cloud, os tipos de crédito incluem:

  • COMMITTED_USAGE_DISCOUNT: contratos de uso contínuo baseados em recursos comprados para o Compute Engine em troca de 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 um valor mínimo.
  • DISCOUNT: o tipo de crédito com desconto é usado para créditos conquistados após um limite contratual de gastos. Nos relatórios do Cloud Billing disponíveis no Partner Sales Console, o tipo de crédito com desconto é listado como Descontos baseados em gastos (contratual).
  • FREE_TIER: alguns serviços oferecem uso gratuito de recursos até os limites especificados. Para esses serviços, os créditos são aplicados para implementar o uso do nível gratuito.
  • PROMOTION: o tipo de crédito promocional inclui 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 aplicados automaticamente para reduzir a fatura total.
  • RESELLER_MARGIN: se você for um revendedor, o tipo de crédito margem do revendedor indicará 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ê recebe por executar recursos específicos do Compute Engine por uma parte significativa do mês de faturamento.

adjustmentsInfo

Para o Google Cloud, esses valores serão preenchidos somente 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 ao uso informado incorreto.
  • PRICE_CORRECTION: uma correção devido a regras de precificação incorretas.
  • METADATA_CORRECTION: uma correção para corrigir metadados sem alterar 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 a outra.
  • ACCOUNT_CLOSURE: um ajuste para levar uma conta encerrada a um saldo zero.
  • 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 dos níveis de preços de SKU. Se sua conta do Cloud Billing tiver preços de contrato personalizados, esse será o preço específico da conta de faturamento. Caso contrário, será o preço de tabela da SKU ou do nível de SKU.