Exportar dados do Channel Services para o BigQuery

Esta página mostra como configurar uma exportação de serviços de canal e também descreve 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ê oferece.

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 suas regras de reprecificação configuradas. Essas exportações também agregam todas as informações sobre as contas de faturamento principais 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 você pode usar consultas para mesclar os dois conjuntos de dados para análise.

Para informações sobre exportações do Cloud Billing que não são de revendedor, consulte 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 BigQuery Data Transfer Service 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, poderá reutilizar esse projeto e 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 dos 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 dos serviços do canal. Ative o faturamento no projeto, caso ainda não esteja ativado.

Ao selecionar ou criar um conjunto de dados do BigQuery, é possível escolher um dos locais do BigQuery com suporte para o conjunto de dados. 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 [BigQuery

    conjunto de dados](/bigquery/docs/datasets-intro) para usar um local multirregional, os dados de exportação do BigQuery estão disponíveis para cada fonte de dados selecionada desde o início do mês anterior. Por exemplo, se você ativar a exportação do BigQuery em 23 de setembro, a exportação vai incluir dados a partir de 1º de agosto.

  • Se você configurar o [BigQuery

    conjunto de dados](/bigquery/docs/datasets-intro) para usar um local de região (exceto multirregional dos EUA ou da UE), os dados de exportação do BigQuery vão estar disponíveis para cada origem de dados selecionada a partir da data em que você ativar a exportação. Ou seja, os dados de exportação do BigQuery não são adicionados de forma retroativa para locais de conjuntos de dados não multirregionais. Portanto, você não vai encontrar dados de exportação do BigQuery 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 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 do BigQuery com suporte

Há dois tipos de regiões com suporte 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-membros (link externo) da União Europeia EU
Data centers nos Estados Unidos US

Regiões

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

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 em que a exportação de dados do BigQuery dos serviços do canal é aceita.

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 na Europa em que a exportação de dados do BigQuery para serviços de canais é 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 refatura.
  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 as exportações de refaturamento

Depois de configurada, a exportação de faturamento mostra mais dados de uso diariamente. A tabela de exportação só vai aparecer quando a exportação de faturamento for executada pela primeira vez na sua conta. O conjunto de dados contém dados de quando ele foi configurado pela primeira vez para reter dados.

Para interromper a exportação dos dados de custo do refaturamento para o conjunto de dados, clique em Desativar 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 o período em que a exportação estiver desativada. Se você excluiu dados exportados durante esse período, não será possível preencher os registros excluídos.

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

A exportação de dados do Channel Services usa uma conta de serviço que é de propriedade do Google e gerenciada por ele, além de ter permissão para gravar registros de faturamento em uma tabela. A conta de serviço é:

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

Essa conta de serviço exige o papel predefinido: roles/bigquery.dataEditor para permitir exportações. Para configurar as permissões, siga as etapas para ativar a exportação.

Consultar dados de forma eficiente

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 dividida em clusters menores. O uso das chaves de cluster e de partição em uma consulta ajuda o BigQuery a localizar rapidamente os dados relevantes, o que pode reduzir significativamente o custo da consulta.

Por exemplo, esta consulta é eficiente em comparação com uma consulta sem chaves de particionamento e de agrupamento:

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, clusterização e práticas recomendadas, consulte os links a seguir:

  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 Faturamento do parceiro.

Você pode conferir 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 exportado

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 podem acessar, recomendamos configurar as Visualizações autorizadas para compartilhar dados do conjunto de dados exportado.

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

Esquema de tabela

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

No seu 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 associada ao uso, que pode ser do cliente ou seu. Dependendo da família de produtos, pode ser uma conta de faturamento ou uma conta 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" é igual a 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 armazenamento padrão dos 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 de hora em 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 de hora em 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 Mostra 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 houver rótulos, a parte chave 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 na hierarquia de recursos do projeto identificado pelo project.id.
labels Estrutura, repetido
labels.key String Se houver rótulos, a parte chave 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 chave 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 Local 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, região ou 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, este 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ços.
resource.name String Um identificador específico do serviço para o recurso que gerou o uso relevante. Pode ser gerado 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 do uso antes de aplicar créditos. 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 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 as marcações de refaturamento e descontos. Com base no channel_partner_name e no ChannelPartnerRepricingConfig associado. 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 as marcações de refaturamento e descontos. Com base no customer_name e no CustomerRepricingConfig associado. 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 nos itens de linha de custo.
adjustmentsInfo.adjustment_id String Se preenchido, um ajuste é 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 de ajuste.
adjustmentsInfo.adjustment_mode String 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á com 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 direito de acesso da API Cloud Channel. Usa o formato: accounts/{account}/customers/{customer}/entitlements/{entitlement}
channel_partner_name String (Somente para distribuidores) O nome do 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 para 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/{conta}/customers/{cliente}.
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 pelo preço público.
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 para distribuidores) O nome do recurso da ChannelPartnerRepricingConfig da API Cloud Channel. 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 foi herdada (tags herdadas = True) ou direta/não herdada (tags herdadas = False).
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. Só é preenchido se houver um ID do 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ço, como 0 a 100 unidades, 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 que representa a quantidade de unidade inicial para os 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, mês de gibibyte 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 1.000.000 de bytes, a coluna mostrará 1.000.000.
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 o 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

Há algumas notas adicionais 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 nesse campo. Os campos a seguir não se aplicam às exportações do Google Workspace:

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

Colunas não aplicáveis a pedidos off-line (pré-lançamento)

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 ou campo. As colunas ou campos a seguir não se aplicam às exportações de faturamento de pedidos off-line:

  • project
  • labels
  • system_labels
  • location
  • resource
  • credits
  • entitlement_name
  • channel_partner_name
  • channel_partner_cost
  • customer_name
  • customer_cost
  • 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 com as exportações do Google Workspace:

  • Os dados do Google Workspace não contêm o 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 impostos são divididos por cliente. Embora o imposto total precise corresponder à fatura, os impostos individuais podem conter pequenas imprecisões de arredondamento.

billing_account_id

  • No Google Cloud, é a conta do Cloud Billing a que o uso está associado.
  • No Google Workspace, é a identidade do cliente no Cloud Identity.
  • Para pedidos off-line, é o nome do cliente.

service e sku

No Google Workspace, essas colunas representam o "Produto" e o "SKU" associados ao uso. Saiba mais sobre os 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, é a hora de início (inclusive) da assinatura, às 0h PST na data de início.
  • Para usage_end_time, é o horário de término (exclusivo) da assinatura, às 0h PST no dia seguinte à data de término.

project.labels

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

labels

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

system_labels

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

  • No Google Workspace, esses são metadados adicionais relacionados ao custo, incluindo:

    • 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 (OC).
    • workspace.googleapis.com/subscription_id: o ID da assinatura.
    • workspace.googleapis.com/usage_type: o tipo de uso. Não relevante 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 com cobrança mensal e para o período de faturamento ou contrato de uma assinatura pré-paga.
  • COMMITMENT_TERM_END_ITEM: término de uma assinatura. Normalmente associado às cobranças do último mês de uma assinatura mensal.
  • COMMITMENT_TERM_RENEWAL_ITEM: início de um período de assinatura complementar.
  • COMMITMENT_MONTHLY_ITEM: uso registrado para compromissos existentes no início do mês. Na maioria dos casos, a cobrança vai se estender por todo o mês.
  • COMMITMENT_SEATS_CHANGE_ITEM: registrado quando o nível de comprometimento muda (aumento ou diminuição). Geralmente, começa no meio do mês e se estende até o fim do mês para uma assinatura mensal com compromisso ou até o fim do período de faturamento ou contrato de uma assinatura pré-paga.
  • COMMITMENT_CANCEL_ITEM: registrado quando uma assinatura é cancelada. Inclui cobranças associadas à rescisão antecipada. Representa uma cobrança pelo restante do período do contrato quando ele é cancelado no meio do período ou um crédito emitido pelo restante do período de faturamento quando um contrato é alterado ou cancelado no meio do período.
  • FLEXIBLE_SEATS_ITEM: registra o uso por um número de usuários em um bloco contíguo de alguns dias. 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 pós-inicialização.
  • COMMITMENT_PREPAY_BILLING_PERIOD_ITEM: representa informações de uso que são criadas no início do ciclo de pagamento de todo o ciclo de uma assinatura de compromisso pré-paga.

usage.amount

No caso de uso baseado em licenças do Google Workspace, isso indica licenças pagas. Por exemplo, as licenças de um compromisso ou o número de licenças pagas flexíveis.

usage.pricing_unit

  • Para o Google Cloud, saiba mais sobre a API Cloud Billing Catalog {: track-type="tasks" class="external" track-name="externalLink" track-metadata-position="body"}
  • No Google Workspace, é count.

credits.id

No Google Cloud, esse campo é 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

No Google Cloud, essa é uma descrição legível por humanos de um credits.id alfanumérico. Por exemplo, crédito do teste sem custos financeiros 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 uso contínuo: CPU ), o campo credits.full_name vai ficar vazio.

credits.type

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

  • COMMITTED_USAGE_DISCOUNT: contratos de uso contínuo com base em recursos para o Compute Engine em retorno a preços com muito desconto para 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 recebidos após um limite de gastos contratual ser atingido. Nos relatórios do Cloud Billing disponíveis no Partner Sales Console, o tipo de crédito com desconto é listado como Descontos com base em gastos (contratuais).
  • 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 teste gratuito do Google Cloud e créditos de campanha de marketing ou outras concessões 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 a fatura total.
  • RESELLER_MARGIN: se você for um revendedor, o tipo de crédito margem do revendedor indica os descontos do programa para revendedores recebidos em cada item de linha qualificado.
  • SUBSCRIPTION_BENEFIT: créditos ganhos ao adquirir assinaturas de longo prazo para 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 em um período significativo do mês de faturamento.

adjustmentsInfo

No Google Cloud, esses valores só são preenchidos se o item de linha de custo for 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

No Google Cloud, isso inclui:

  • USAGE_CORRECTION: uma correção devido ao uso informado incorretamente.
  • 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 pela loja, como parte de um contrato.
  • SLA_VIOLATION: um crédito emitido para o cliente devido a uma violação de objetivo de nível de serviço (SLO).
  • BALANCE_TRANSFER: um ajuste para transferir fundos de uma conta para pagamento para outra.
  • ACCOUNT_CLOSURE: um ajuste para zerar o saldo de uma conta encerrada.
  • GENERAL_ADJUSTMENT: uma modificação geral da conta do Cloud Billing.

adjustmentsInfo.adjustment_mode

No 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 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 uso adicional é monetizado novamente.
  • MANUAL_ADJUSTMENT: o ajuste é alocado para custo e uso manualmente.

price.effective_price

No 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 da SKU. Se a conta do Cloud Billing tiver preços personalizados e sob contrato, esse preço será específico do Cloud Billing. Caso contrário, esse é o preço de tabela da SKU ou do nível da SKU.