Exportar dados do Channel Services para o BigQuery

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

Com o BigQuery, você pode exportar Dados de faturamento do Channel Services para um BigQuery especificado no conjunto de dados. Esses dados podem ajudar você a realizar uma análise detalhada de como seus clientes ou parceiros de canal estão usando o e serviços fornecidos por você.

As exportações do Channel Services contêm dados específicos do revendedor incluídas 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 todos mais informações sobre os clientes contas de faturamento principais em um único conjunto de dados.

No entanto, os dados de uma exportação do Channel Services são compatíveis com Exportações do Cloud Billing, e é possível 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 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 é ativada 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 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 Exportação de dados do Cloud Billing para no 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:

• No BigQuery, se você criou o conjunto de dados de destino, é preciso 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, no Partner Sales Console, você precisa ter a função de administrador de revendedor do Google Cloud.

  Saiba como atribuir papéis do Google Cloud 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 para o projeto que contém 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 em BigQuery para armazenar os dados do Channel Services. Ativar faturamento no projeto, caso ainda não esteja ativado.

Quando você seleciona ou cria um BigQuery conjunto de dados, você é possível escolher um dos locais compatíveis com o BigQuery para no conjunto de dados. Quando você ativa a exportação de dados do Channel Services para a primeira tempo 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 vão estar disponíveis para cada fonte de dados selecionada desde o início do mês anterior. Por exemplo, se você ativar BigQuery Export em 23 de setembro, sua exportação incluirá a partir de 1o de agosto.

• Se você configurar o BigQuery conjunto de dados para usar uma região localização (exceto as multirregionais EUA ou UE), a exportação do BigQuery dados estão disponíveis para cada fonte de dados selecionada a partir da data em que você ativar o exportar, e depois. 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. Quando você configura a exportação dos dados de faturamento em cada Partner Sales Console selecione o conjunto de dados unificado.

Locais compatíveis com o BigQuery

Locais multirregionais

A tabela a seguir lista as multirregiões onde o Channel Services A exportação de dados do BigQuery é aceita.

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.

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

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

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 página.
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. O a tabela de exportação não será exibida até que a exportação de faturamento seja executada para sua conta para pela primeira vez. O conjunto de dados contém dados de quando foi configurado pela primeira vez para e reter dados.

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

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 a gerenciada pelo Google e tem permissão para gravar registros de faturamento em uma tabela. O conta de serviço é:

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

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

Consulte dados com eficiência

A tabela do BigQuery está particionada por export_time e armazenada em cluster por payer_billing_account_id por padrão. Isso significa que a tabela está dividida em partições menores, que são divididas em clusters menores. Como usar as chaves de partição e de cluster em uma consulta, o BigQuery pode ajudar o BigQuery a localizar rapidamente os dados relevantes, reduzir significativamente o custo da consulta.

Por exemplo, a consulta abaixo é eficiente em comparação a uma sem 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, agrupamento 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 de parceiros.

É 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 nos dados BigQuery Export. Para mais informações, consulte a controles de acesso do BigQuery.

Para garantir que os usuários tenham acesso apenas aos dados a que estão autorizados recomendamos configurar a configuração Autorizados, vistas para compartilhar os dados das visualizações no conjunto 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 para exportação contínua de dados.

Esquema de tabela

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

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

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 de produtos conterá null nessa coluna/campo. O seguinte As colunas/campos 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 o uso do revendedor.
• Quando cost_type for 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. Em exportação, os impostos são divididos por cliente. Embora o total de impostos deva correspondem à fatura, os tributos individuais podem conter pequenas imprecisões no arredondamento.

billing_account_id

• No Google Cloud, essa é a conta do Cloud Billing em que o está associado.
• No Google Workspace, é o ID do Cloud Identity da cliente.

service e sku

No Google Workspace, essas colunas representam a coluna "Produto". e "SKU" associados ao uso. Saiba mais sobre Produtos e SKU Documentos de identificação ,

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

project.labels

Para o Google Cloud, são os pares de chave-valor na Projeto do Google Cloud em que o uso ocorreu. Para mais informações, consulte Uso Rótulos ,

labels

Para o Google Cloud, estes são os pares de chave-valor no serviço recurso em que o uso ocorreu. Para mais informações, consulte Usar Rótulos ,

system_labels

• Para o Google Cloud, são os pares de chave-valor na Recurso do Google Cloud em que o uso ocorreu. Para mais informações, consulte Sistemas disponíveis rótulos.

• 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: a ordem de compra (PO, na sigla em inglês). ID.
  • 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 associadas 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: término de uma assinatura. Normalmente associados a as cobranças do último mês de uma assinatura de compromisso faturada mensalmente.
• COMMITMENT_TERM_RENEWAL_ITEM: início de um período de assinatura subsequente.
• COMMITMENT_MONTHLY_ITEM: uso registrado para compromissos existentes no início do mês. Na maioria dos casos, a carga se estenderá mês inteiro.
• 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 fim para uma assinatura de compromisso mensal ou até o fim do período de faturamento/contrato de uma assinatura pré-paga.
• COMMITMENT_CANCEL_ITEM: registrado quando uma assinatura é cancelada. Inclui cobranças associadas ao encerramento antecipado. Representa um cobrança pelo restante do período contratual quando o contrato é cancelado ou um crédito emitido para o restante do período de faturamento, quando contratados são alterados ou cancelados no meio do processo.
• FLEXIBLE_SEATS_ITEM: registra o uso por para um determinado número de usuários para um bloco contíguo de um 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 pós-inicialização.
• COMMITMENT_PREPAY_BILLING_PERIOD_ITEM: representa uma informação de uso que é criado no início do ciclo de pagamento para todo o ciclo de um assinatura de pré-pagamento de compromisso.

usage.amount

No caso do uso de licenças do Google Workspace, isso indica as licenças pagas. Para por exemplo, licenças contratadas para compromissos ou número de licenças pagas com flexibilidade.

usage.pricing_unit

• Para o Google Cloud, saiba mais sobre a API Cloud Billing Catalog.
• No Google Workspace, é count.

credits.id

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

credits.full_name

Para o Google Cloud, essa é uma descrição legível por humanos alfanumérica credits.id. Os exemplos incluem Teste gratuito crédito ou comprometimento com base em gastos desconto , Os valores credits.full_name são preenchidos apenas para SKUs com um alfanumérico credits.id. 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 para preços com grandes descontos pelo uso de VMs.
• COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE : contratos de uso contínuo com base em gastos comprados para serviços em troca de seu compromisso de gastar um valor mínimo.
• DISCOUNT: o tipo de crédito "desconto" é usado para créditos recebidos após um o limite contratual de gastos é 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é limites Nesses serviços, os créditos são aplicados para implementar o uso do nível gratuito.
• PROMOTION: o tipo de crédito promocional inclui Google Cloud Free período de teste e em créditos de campanhas de marketing ou outros benefícios para usar o Google Cloud. Quando disponíveis, os créditos promocionais são considerados uma forma de pagamento e são aplicada automaticamente para reduzir o valor total da fatura.
• RESELLER_MARGIN: se você for um revendedor, a margem do revendedor. O tipo de crédito indica os descontos do Programa de Revendedores recebidos em cada item de linha qualificado.
• SUBSCRIPTION_BENEFIT: créditos recebidos pela compra de assinaturas de longo prazo aos serviços em troca de descontos.
• SUSTAINED_USAGE_DISCOUNT : O tipo de crédito "Descontos por uso prolongado" é um desconto automático que você ganhos por executar recursos específicos do Compute Engine por um do mês de faturamento.

adjustmentsInfo

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

adjustmentsInfo.adjustment_type

Para o 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 um nível de serviço de violação do objetivo de negócios (SLO, na sigla em inglês).
• BALANCE_TRANSFER: um ajuste para transferir fundos de uma conta para pagamentos ao outro.
• ACCOUNT_CLOSURE: um ajuste para zerar uma conta encerrada. equilíbrio.
• 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 original e custo.
• COMPLETE_NEGATION_WITH_REMONETIZATION: a correção nega totalmente a o uso e o custo originais, e emite os itens de linha corrigidos com uso e custo.
• COMPLETE_NEGATION: a correção nega totalmente o uso original. custo e nenhum outro uso será 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 dos SKUs e preços das SKUs do Google Cloud ou da Plataforma Google Maps níveis. Se sua conta do Cloud Billing tiver preços de contrato personalizados, este será seu preço específico da conta de faturamento caso contrário, esta será a lista Preço da SKU ou nível de SKU.