Exporte dados dos serviços de canal 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, pode exportar os dados de faturação dos serviços de canal para um conjunto de dados do BigQuery especificado. Estes dados podem ajudar a fazer uma análise detalhada da forma como os seus clientes ou parceiros de canal estão a usar os serviços que fornece.

As exportações dos serviços de canal contêm dados específicos do revendedor que não estão incluídos nas exportações da Faturação do Google Cloud. Isto inclui os custos, os créditos e os dados de utilização com as regras de alteração de preços configuradas. Estas exportações também agregam todas as informações sobre as contas de faturação principais dos seus clientes num único conjunto de dados.

No entanto, os dados de uma exportação dos serviços de canal são compatíveis com as exportações da faturação do Google Cloud, e pode usar consultas para juntar ambos os conjuntos de dados para análise.

Para ver informações sobre exportações da faturação do Google Cloud que não sejam de revendedores, consulte o artigo Configure exportações da faturação do Google Cloud para o BigQuery.

Antes de começar

Antes de começar a exportar dados de faturação dos serviços de canal, tem de:

• Configure um projeto para alojar o seu conjunto de dados do BigQuery. Certifique-se de que a faturação está 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 já tiver um projeto e um conjunto de dados do BigQuery para as exportações de dados de faturação do Google Cloud , pode reutilizar esse projeto e conjunto de dados para a exportação dos serviços de canal.

Para obter informações detalhadas sobre a configuração de um projeto e um conjunto de dados, consulte o artigo Configure a exportação de dados de faturação do Google Cloud para o BigQuery.

Autorizações necessárias para exportações

Para ativar e configurar as exportações dos serviços de canal, precisa das seguintes funções:

• Para o BigQuery, se 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 tiver sido criado por outra pessoa, precisa da função BigQuery Data Owner.

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

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

• Para ativar as exportações do Google Workspace, tem de ser um administrador revendedor ou ter os privilégios de faturação do Google Workspace.

  Saiba como atribuir funções do Google Workspace na Consola de vendas de parceiros

• (Opcional) Project Viewer para o projeto que contém o conjunto de dados do BigQuery de destino, para verificar automaticamente se a faturação está ativada no projeto.

Selecione um projeto e um conjunto de dados

Na Partner Sales Console, selecione um projeto e um conjunto de dados no BigQuery para armazenar os dados dos serviços de canal. Ative a faturação no projeto, se ainda não estiver ativada.

Quando seleciona ou cria um conjunto de dados do BigQuery, pode escolher uma das localizações suportadas do BigQuery para o conjunto de dados. Quando ativa a exportação de dados dos serviços de canal pela primeira vez por origem de dados (Google Cloud ou Google Workspace):

• Se configurar o conjunto de dados do BigQuery para usar uma localização multirregião, os dados de exportação do BigQuery estão disponíveis para cada origem de dados selecionada a partir do início do mês anterior. Por exemplo, se ativar o BigQuery Export a 23 de setembro, a exportação inclui dados a partir de 1 de agosto.

• Se configurar o conjunto de dados do BigQuery para usar uma localização de região (que não seja a multirregião dos EUA ou da UE), os dados do BigQuery Export estão disponíveis para cada origem de dados selecionada a partir da data em que ativa a exportação e posteriormente. Ou seja, os dados de exportação do BigQuery não são adicionados retroativamente para localizações de conjuntos de dados que não sejam multirregionais, pelo que não verá dados de exportação do BigQuery anteriores à ativação da exportação.

Para exportar dados de faturação de várias contas da Partner Sales Console, siga estes passos:

1. No conjunto de dados do BigQuery para o qual quer exportar os seus dados, certifique-se de que os administradores de faturação de cada conta da Partner Sales Console têm autorizações para ver o conjunto de dados.
2. Quando configurar a exportação de dados de faturação em cada conta da Partner Sales Console, selecione o conjunto de dados unificado.

Localizações do BigQuery suportadas

Existem dois tipos de regiões suportadas pelo BigQuery.

Várias regiões

A tabela seguinte lista as multirregiões onde a exportação de dados do BigQuery dos serviços de canal é suportada.

Regiões

A tabela seguinte indica as regiões nas Américas onde a exportação de dados do BigQuery dos serviços de canal é suportada.

A tabela seguinte indica as regiões na Ásia-Pacífico onde a exportação de dados do BigQuery dos serviços de canal é suportada.

A tabela seguinte indica as regiões na Europa onde a exportação de dados do BigQuery dos serviços de canal é suportada.

Ative a exportação

Antes de ativar a exportação de dados, tome nota do ID do conjunto de dados totalmente qualificado, que está no formato PROJECT_ID:DATASET_NAME.

Para ativar a exportação dos serviços de canal:

1. Na Partner Sales Console, abra a página Faturação.
2. Selecione Exportação de faturação.
3. Introduza o ID do conjunto de dados totalmente qualificado no campo Conjunto de dados da refaturação.
4. Selecione as origens de dados para as quais quer exportar dados.
5. Clique em Atualizar. Se vir um pedido para atualizar as autorizações do conjunto de dados, clique em Atualizar.

Após a configuração, a exportação de faturação envia diariamente dados de utilização incrementais. A tabela de exportação não é apresentada até que a exportação de faturação seja executada pela primeira vez para a sua conta. O conjunto de dados contém dados desde a primeira configuração para reter dados.

Para parar de exportar dados de custos de refaturação para o conjunto de dados, clique em Desativar exportação de dados de faturação na página Refaturação de clientes. Para reativar a exportação, siga os passos anteriores para especificar um ID do conjunto de dados.

Os dados de custos de refaturação podem estar indisponíveis durante o período em que estiveram desativados. Se tiver eliminado dados exportados durante esse período, não podemos preencher os registos eliminados.

Autorizações da conta de serviço necessárias

A exportação de dados dos serviços de canal usa uma conta de serviço que é propriedade da Google e é gerida por esta, e tem autorização para escrever registos de faturação numa tabela. A conta de serviço é:

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

Esta conta de serviço requer a função predefinida: roles/bigquery.dataEditor para permitir exportações. Pode configurar as autorizações seguindo os passos para ativar a exportação.

Consulte dados de forma eficiente

A tabela do BigQuery é particionada por export_time e agrupada por payer_billing_account_id por predefinição. Isto significa que a tabela está dividida em partições mais pequenas, cada uma das quais está ainda dividida em clusters mais pequenos. A utilização das chaves de partição e de cluster numa 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 partição e 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 a partição, o agrupamento e as práticas recomendadas, consulte os seguintes links:

1. Consultar tabelas particionadas
2. Consultar tabelas agrupadas
3. Otimize o cálculo de consultas
4. Práticas recomendadas para controlar os custos no BigQuery

Encontrar o ID da conta de faturação do autor do pagamento

Para encontrar o ID da conta de faturação do responsável pelo pagamento, abra a página de contas de faturação da Partner Sales Console e clique no separador Faturação de parceiros.

Pode ver todas as contas de faturação e os IDs das contas de faturação do responsável pelo pagamento.

Configurar controlos de acesso para outros utilizadores no conjunto de dados de exportação

Existem várias formas de configurar controlos de acesso aos dados no BigQuery Export. Para mais informações, consulte os controlos de acesso do BigQuery.

Para garantir que os utilizadores só têm acesso aos dados que têm autorização para ver, recomendamos que configure vistas autorizadas para partilhar dados do seu conjunto de dados exportado.

Para a exportação de dados contínua, quando configurar autorizações para utilizadores, certifique-se de que a conta de serviço tem sempre acesso total de editor no conjunto de dados de exportação.cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com

Esquema da tabela

O esquema seguinte descreve os dados na tabela do BigQuery.

No conjunto de dados do BigQuery, a exportação de refaturação detalhada é carregada numa tabela de dados denominada reseller_billing_detailed_export_v1.

Notas adicionais sobre o esquema

Existem 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 esta família de produtos contêm null neste campo. Os seguintes campos 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 a 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 esta família de produtos contêm null neste campo. Os seguintes campos 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 encomendas offline (pré-visualização)

Quando uma coluna ou um campo não se aplica a uma família de produtos, os dados exportados para esta família de produtos contêm null nesta coluna ou campo. As seguintes colunas ou campos não se aplicam às exportações de faturação de encomendas offline:

• 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 notas sobre a exportação do Google Workspace

Existem vários comportamentos especiais com as exportações do Google Workspace:

• Os dados do Google Workspace não contêm a utilização do próprio revendedor.
• Quando cost_type é tax e adjustment, usage.amount_in_pricing_units é sempre 1.
• Nas faturas do Google Workspace, os impostos são apresentados como um item de linha. Na exportação, os impostos são discriminados por cliente. Embora o imposto total deva corresponder ao da fatura, os impostos individuais podem conter pequenas imprecisões de arredondamento.

billing_account_id

• Para Google Cloud, esta é a conta do Cloud Billing à qual a utilização está associada.
• Para o Google Workspace, este é o Cloud ID do cliente.
• Para encomendas offline, este é o nome do cliente.

service e sku

Para o Google Workspace, estas colunas representam o "Produto" e o "SKU" associados à utilização. Saiba mais sobre os IDs de produtos e SKUs .

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, isto é representado como datas. Nas exportações, estes são representados como datas/horas:

• Para usage_start_time, esta é a hora de início (inclusive) da subscrição, às 0:00 PST na data de início.
• Para usage_end_time, esta é a hora de fim (exclusiva) da subscrição, às 0:00 PST no dia seguinte à data de fim.

project.labels

Para Google Cloud, estes são os pares de chave:valor no Google Cloud projeto onde a utilização ocorreu. Para mais informações, consulte o artigo Usar etiquetas .

labels

Para Google Cloud, estes são os pares de chave:valor no Google Cloud recurso onde a utilização ocorreu. Para mais informações, consulte o artigo Usar etiquetas .

system_labels

• Para Google Cloud, estes são os pares de chave:valor no recursoGoogle Cloud onde a utilização ocorreu. Para mais informações, consulte Etiquetas do sistema disponíveis.

• Para o Google Workspace, estes são metadados adicionais relativos ao custo, que incluem:

  • workspace.googleapis.com/domain_name: o nome do domínio do cliente.
  • workspace.googleapis.com/order_id: o ID da encomenda.
  • workspace.googleapis.com/purchase_order_id: o ID da nota de encomenda (PO).
  • workspace.googleapis.com/subscription_id: o ID da subscrição.
  • workspace.googleapis.com/usage_type: o tipo de utilização. Não aplicável se cost_type não for regular.

Os tipos de utilização do Google Workspace incluem:

• COMMITMENT_TERM_START_ITEM: início de uma subscrição. Normalmente, está associado a um mês parcial para uma subscrição de compromisso faturada mensalmente e ao período de faturação ou contratual para uma subscrição pré-paga.
• COMMITMENT_TERM_END_ITEM: fim de uma subscrição. Normalmente associado às cobranças do último mês de uma subscrição de compromisso com faturação mensal.
• COMMITMENT_TERM_RENEWAL_ITEM: início de um período de subscrição subsequente.
• COMMITMENT_MONTHLY_ITEM: utilização registada para compromissos existentes no início do mês. Na maioria dos casos, a cobrança é feita durante todo o mês.
• COMMITMENT_SEATS_CHANGE_ITEM: registado quando o nível de compromisso muda (aumenta ou diminui). Começa frequentemente a meio do mês e prolonga-se até ao final do mês para uma subscrição de compromisso com faturação mensal ou até ao final do período de faturação ou contratual para uma subscrição pré-paga.
• COMMITMENT_CANCEL_ITEM: registado quando uma subscrição é cancelada. Inclui cobranças associadas à rescisão antecipada. Representa uma cobrança pelo período restante do contrato quando o contrato é cancelado a meio ou um crédito emitido pelo período restante de faturação quando um contrato é alterado ou cancelado a meio.
• FLEXIBLE_SEATS_ITEM: regista a utilização por um determinado número de utilizadores durante um bloco contíguo de um determinado número de dias. Destinado apenas a utilizadores sem um compromisso.
• COUPON_DISCOUNT_ITEM: montante do desconto associado a um cupão.
• MIGRATED_CREDIT_ITEM: crédito da migração do Postini.
• COMMITMENT_PREPAY_BILLING_PERIOD_ITEM: representa informações de utilização criadas no início do ciclo de pagamento para todo o ciclo de uma subscrição pré-paga com compromisso.

usage.amount

Para a utilização baseada em postos do Google Workspace, isto indica postos pagos. Por exemplo, lugares comprometidos para compromissos ou número de lugares pagos para flex.

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

usage.pricing_unit

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

credits.id

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

credits.full_name

Para Google Cloud, esta é uma descrição legível de um caráter alfanumérico credits.id. Os exemplos incluem crédito de avaliação gratuita ou desconto por utilização comprometida baseado em gastos . Os valores credits.full_name só são preenchidos para SKUs com um valor alfanumérico credits.id. Se o valor de credits.id for uma descrição do tipo de crédito (como desconto por utilização comprometida: CPU), o campo credits.full_name estará vazio.

credits.type

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

• COMMITTED_USAGE_DISCOUNT: Contratos de fidelização baseados em recursos comprados para o Compute Engine em troca de preços significativamente reduzidos para a utilização de VMs.
• COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE : Contratos de utilização comprometida baseados em gastos comprados para serviços em troca do seu compromisso de gastar um valor mínimo.
• DISCOUNT: o tipo de crédito de desconto é usado para créditos ganhos após atingir um limite de gastos contratual. Tenha em atenção que, nos relatórios de faturação do Google Cloud disponíveis na Consola de vendas de parceiros, o tipo de crédito de desconto é apresentado como Descontos baseados em gastos (contratuais).
• FREE_TIER : Alguns serviços oferecem utilização de recursos gratuita até aos limites especificados Para estes serviços, os créditos são aplicados para implementar a utilização do nível gratuito.
• PROMOTION: O tipo de crédito promocional inclui Google Cloud Avaliação gratuita e créditos de campanhas 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 for um revendedor, o tipo de crédito margem do revendedor indica os descontos do programa para revendedores ganhos em cada elemento publicitário elegível.
• SUBSCRIPTION_BENEFIT: créditos ganhos através da compra de subscrições de longo prazo de serviços em troca de descontos.
• SUSTAINED_USAGE_DISCOUNT : O tipo de crédito de descontos por utilização sustentada é um desconto automático que ganha por executar recursos específicos do Compute Engine durante uma parte significativa do mês de faturação.

adjustmentsInfo

Para Google Cloud, estes valores só são preenchidos se o elemento publicitário de custo tiver sido gerado para uma modificação do Cloud Billing. O adjustmentsInfo tipo contém detalhes sobre o ajuste, quer tenha sido emitido para corrigir um erro ou por outros motivos.

adjustmentsInfo.adjustment_type

Para Google Cloud, isto inclui:

• USAGE_CORRECTION: uma correção devido a uma utilização comunicada incorretamente.
• PRICE_CORRECTION: uma correção devido a regras de preços incorretas.
• METADATA_CORRECTION: Uma correção para corrigir metadados sem alterar o custo.
• GOODWILL: um crédito emitido ao cliente por boa vontade.
• SALES_BASED_GOODWILL: um crédito emitido ao cliente por boa vontade, como parte de um contrato.
• SLA_VIOLATION: Um crédito emitido ao cliente devido a uma violação do objetivo ao nível do serviço (SLO).
• BALANCE_TRANSFER: um ajuste para transferir fundos de uma conta de pagamentos para outra.
• ACCOUNT_CLOSURE: um ajuste para colocar uma conta encerrada com um saldo de zero.
• GENERAL_ADJUSTMENT: Uma modificação geral da conta do Cloud Billing.

adjustmentsInfo.adjustment_mode

Para Google Cloud, isto inclui:

• PARTIAL_CORRECTION: a correção anula parcialmente a utilização e o custo originais.
• COMPLETE_NEGATION_WITH_REMONETIZATION: a correção anula totalmente a utilização e o custo originais e emite elementos publicitários corrigidos com a utilização e o custo atualizados.
• COMPLETE_NEGATION: a correção anula totalmente a utilização e o custo originais, e não é rentabilizada nenhuma utilização adicional.
• MANUAL_ADJUSTMENT: o ajuste é atribuído ao custo e à utilização manualmente.

price.effective_price

Para Google Cloud, este é o preço cobrado pela utilização dos SKUs da Google Cloud ou da Google Maps Platform e dos níveis de preços dos SKUs. Se a sua conta do Cloud Billing tiver preços de contrato personalizados, este preço é específico do seu Cloud Billing. Caso contrário, este é o preço de tabela do SKU ou do nível do SKU.