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 do BigQuery especificado. Esses dados podem ajudar você a fazer 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 são incluídos nas exportações do Cloud Billing. Isso inclui custos, créditos e dados de uso com suas regras de substituição de preç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 unir os dois conjuntos de dados para análise.

Para informações sobre exportações do Cloud Billing que não são de revendedores, 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 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 das seguintes funções:

• Para o BigQuery, se você criou o conjunto de dados de destino, precisa de BigQuery User para o projeto que contém o conjunto de dados. Se o conjunto de dados foi criado por outra pessoa, você precisa da função BigQuery Data Owner.

• Para ativar as exportações do Google Cloud , você precisa ter a função de administrador revendedor Google Cloud no Partner Sales Console.

  Saiba como atribuir funções Google Cloud no Partner Sales Console

• Para ativar as exportações do Google Workspace, você precisa ser um admin revendedor ou ter os privilégios de faturamento do Google Workspace.

  Saiba como atribuir funções do Google Workspace no Partner Sales Console

• (Opcional) Project Viewer para o 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 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 compatíveis do BigQuery para o conjunto de dados. Ao ativar 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 estarã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 conjunto de dados do BigQuery para usar um local de região (que não seja multirregional dos EUA ou da 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 de forma retroativa para locais de conjuntos de dados não multirregionais. Portanto, você não verá os dados do BigQuery Export de 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 compatíveis

Há dois tipos de regiões compatíveis com o BigQuery.

Locais multirregionais

A tabela a seguir lista as multirregiões em que a exportação de dados do BigQuery dos serviços de canal está disponível.

Regiões

A tabela a seguir lista as regiões das Américas em que a exportação de dados do BigQuery dos serviços de canal está disponível.

A tabela a seguir lista as regiões da Ásia-Pacífico em que a exportação de dados do BigQuery dos serviços de canal está disponível.

A tabela a seguir lista as regiões da Europa onde a exportação de dados do BigQuery dos serviços do canal está disponível.

Ativar a exportação

Antes de ativar a exportação de dados, anote o ID totalmente qualificado do conjunto de dados, 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.

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 informações desde a primeira configuração para retenção de 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 e especifique um ID do conjunto de dados.

Os dados de custo de refaturamento podem não estar disponí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 da conta de serviço

A exportação de dados do Channel Services usa uma conta de serviço que pertence ao 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 a função predefinida: roles/bigquery.dataEditor para permitir exportações. Para configurar as permissões, siga as etapas para ativar a exportação.

Consultar dados com eficiência

Por padrão, a tabela do BigQuery é particionada por export_time e agrupada por payer_billing_account_id. Isso significa que a tabela é dividida em partições menores, cada uma delas dividida 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, esta consulta é eficiente em comparação com uma consulta 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 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.

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 só tenham acesso aos dados que estão autorizados a visualizar, recomendamos configurar visualizações autorizadas para compartilhar dados do seu conjunto de dados exportado.

Para a exportação contínua de dados, 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 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.

Outras observações sobre o esquema

Há algumas observações 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
• price.list_price
• price.effective_price_default
• price.list_price_consumption_model
• transaction_type
• seller_name
• consumption_model

Colunas não aplicáveis às SKUs de consumo do 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:

• service.id
• sku.id
• project
• labels
• resource
• customer_repricing_config_name
• channel_partner_repricing_config_name
• tags
• price.effective_price
• price.tier_start_amount
• transaction_type
• seller_name
• subscription

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

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
• price.list_price
• price.effective_price_default
• price.list_price_consumption_model
• transaction_type
• seller_name
• consumption_model

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 incluem o uso do próprio revendedor.
• Quando cost_type é tax e adjustment, usage.amount_in_pricing_units é sempre 1.
• Nas faturas do Google Workspace, os tributos aparecem 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 ter pequenas imprecisões de arredondamento.

billing_account_id

• Para Google Cloud, essa é a conta do Cloud Billing associada ao uso.
• Para o Google Workspace, é o Cloud Identity do cliente.
• Para pedidos off-line, é o nome do cliente.

service e sku

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

Para SKUs de consumo do Google Workspace (Google Voice e Drive), as colunas sku.id e service.id contêm null.

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 0h (horário do Pacífico) na data de início.
• Para usage_end_time, esse é o horário de término (exclusivo) da assinatura, às 0h PST do dia seguinte à data de término.

project.labels

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

labels

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

system_labels

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

• No Google Workspace, esses são 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).
  • 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 com faturamento mensal e ao período de faturamento ou contrato de uma assinatura pré-paga.
• COMMITMENT_TERM_END_ITEM: fim de uma assinatura. Normalmente associado às cobranças do último mês de uma assinatura por contrato com faturamento 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 durar o mês inteiro.
• COMMITMENT_SEATS_CHANGE_ITEM: registrado quando o nível de compromisso muda (aumenta ou diminui). Geralmente começa no meio do mês e vai até o final do mês para uma assinatura mensal ou até o final do período de faturamento ou do contrato para 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 caminho ou um crédito emitido pelo restante do período de faturamento quando um contrato é alterado ou cancelado no meio do caminho.
• FLEXIBLE_SEATS_ITEM: registra o uso por um determinado número de usuários em um bloco contíguo de um determinado número de dias. Destinado apenas a usuários sem um compromisso.
• COUPON_DISCOUNT_ITEM: valor do desconto associado a um cupom.
• MIGRATED_CREDIT_ITEM: crédito da migração do postini.
• 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 pré-paga por fidelidade.

usage.amount

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

Para SKUs de consumo do Google Workspace (Google Voice e Drive), esse é o número de minutos usados.

usage.pricing_unit

• Para 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

Para Google Cloud, esse é 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 Google Cloud, esta é uma descrição legível de um credits.id alfanumérico. Por exemplo: Crédito de avaliação gratuita ou Desconto por uso contínuo com base em gastos . Os valores credits.full_name só são preenchidos 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 ficará vazio.

credits.type

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

• COMMITTED_USAGE_DISCOUNT: Contratos por 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 por uso contínuo com base em gastos adquiridos para serviços em troca do seu compromisso em 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 Google Cloud teste gratuito e créditos de campanha de marketing ou outras concessões para usar 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 de 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ê ganha ao usar recursos específicos do Compute Engine em um período significativo do mês de faturamento.

adjustmentsInfo

Para Google Cloud, esses valores só serã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

Para 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 pagamentos para outra.
• ACCOUNT_CLOSURE: um ajuste para levar uma conta encerrada a um saldo zero.
• GENERAL_ADJUSTMENT: uma modificação geral da conta do Cloud Billing.

adjustmentsInfo.adjustment_mode

Para 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

Para 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 de contrato, esse preço será específico para o faturamento do Cloud. Caso contrário, será o preço de tabela da SKU ou do nível de SKU.