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:
Para o BigQuery, se você criou o conjunto de dados de destino, é necessário
BigQuery User
para o projeto que contém o conjunto de dados. Se o conjunto de dados tiver sido criado por outra pessoa, você precisará do papelBigQuery Data Owner
.Para ativar as exportações do Google Cloud, no Partner Sales Console, você precisa ter a função de administrador revendedor do Google Cloud.
Saiba como atribuir funções do Google Cloud no Partner Sales Console
Para ativar as exportações do Google Workspace, você precisa ser um administrador revendedor ou ter os privilégios do Faturamento do Google Workspace.
Saiba como atribuir funções do Google Workspace no Partner Sales Console
(Opcional)
Project Viewer
no projeto que contém o conjunto de dados de destino do BigQuery, para verificar automaticamente se o faturamento está ativado no projeto.
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:
- 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.
- 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:
- No Partner Sales Console, abra a página Faturamento.
- Selecione Exportação de faturamento.
- Insira o ID do conjunto de dados totalmente qualificado no campo Conjunto de dados de refaturamento.
- Selecione as fontes de dados para exportar os dados.
- Clique em Atualizar. Se for exibida uma solicitação para atualizar as permissões do conjunto de dados, clique em Atualizar.
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:
- Consultar tabelas particionadas
- Consultar tabelas em cluster
- Otimizar a computação em consultas
- 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.
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:
|
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
eadjustment
,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 secost_type
não forregular
.
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
- Para o Google Cloud, saiba mais sobre a API Cloud Billing Catalog.
- No Google Workspace, o nome é
count
.
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.