Exporter des données Channel Services vers BigQuery

Cette page vous explique comment configurer une exportation des services de chaîne et décrit le schéma disponible pour une exportation.

BigQuery vous permet d'exporter les données de facturation Channel Services vers un ensemble de données BigQuery spécifique. Ces données peuvent vous aider à analyser en détail la façon dont vos clients ou partenaires commerciaux utilisent les services que vous fournissez.

Les exportations depuis Channel Services contiennent des données spécifiques aux revendeurs qui ne sont pas incluses dans les exportations Cloud Billing. Elle inclut les coûts, les crédits et les données d'utilisation avec vos règles de nouveau tarif configurées. Ces exportations agrègent également toutes les informations sur les comptes de facturation parents de vos clients dans un seul ensemble de données.

Toutefois, les données d'une exportation Channel Services sont compatibles avec les exportations Cloud Billing. Vous pouvez utiliser des requêtes pour joindre les deux ensembles de données à des fins d'analyse.

Pour en savoir plus sur les exportations Cloud Billing non destinées aux revendeurs, consultez Configurer les exportations Cloud Billing vers BigQuery.

Avant de commencer

Avant de commencer à exporter les données de facturation Channel Services, vous devez :

• Configurez un projet pour héberger votre ensemble de données BigQuery. Assurez-vous que la facturation est activée pour le projet.
• Activez l'API du service de transfert de données BigQuery dans le projet.
• Créez un ensemble de données pour vos données exportées.

Si vous disposez déjà d'un projet et d'un ensemble de données BigQuery pour les exportations de données Cloud Billing, vous pouvez les réutiliser pour l'exportation Channel Services.

Pour en savoir plus sur la configuration d'un projet et d'un ensemble de données, consultez Configurer l'exportation des données Cloud Billing vers BigQuery.

Autorisations requises pour les exportations

Pour activer et configurer les exportations Channel Services, vous devez disposer des rôles suivants :

• Pour BigQuery, si vous avez créé l'ensemble de données cible, vous avez besoin de BigQuery User pour le projet contenant l'ensemble de données. Si l'ensemble de données a été créé par une autre personne, vous devez disposer du rôle BigQuery Data Owner.

• Pour activer les exportations Google Cloud , vous devez disposer du rôle d'administrateur du revendeur Google Cloud dans Partner Sales Console.

  En savoir plus sur l'attribution de Google Cloud rôles dans la console Ventes partenaires

• Pour activer les exportations Google Workspace, vous devez être un administrateur revendeur ou disposer des droits de facturation Google Workspace.

  En savoir plus sur l'attribution de rôles Google Workspace dans la console Partner Sales

• (Facultatif) Project Viewer pour le projet contenant l'ensemble de données BigQuery cible, afin de vérifier automatiquement si la facturation est activée pour le projet.

Sélectionner un projet et un ensemble de données

Dans la Partner Sales Console, sélectionnez un projet et un ensemble de données dans BigQuery pour stocker les données des services de chaîne. Activez la facturation sur le projet si ce n'est pas déjà fait.

Lorsque vous sélectionnez ou créez un ensemble de données BigQuery, vous pouvez choisir l'un des emplacements BigQuery compatibles pour l'ensemble de données. Lorsque vous activez l'exportation des données Channel Services pour la première fois par source de données (Google Cloud ou Google Workspace) :

• Si vous configurez votre ensemble de données BigQuery pour utiliser un emplacement multirégional, les données d'exportation BigQuery sont disponibles pour chaque source de données sélectionnée à partir du début du mois précédent. Par exemple, si vous activez l'exportation vers BigQuery le 23 septembre, votre exportation inclura les données à compter du 1er août.

• Si vous configurez votre ensemble de données BigQuery pour utiliser un emplacement régional (autre que multirégional aux États-Unis ou dans l'UE), vos données d'exportation BigQuery sont disponibles pour chaque source de données sélectionnée à partir de la date d'activation de l'exportation. Autrement dit, les données d'exportation BigQuery ne sont pas ajoutées rétroactivement pour les emplacements d'ensembles de données non multirégionaux. Par conséquent, vous ne verrez pas les données d'exportation BigQuery datant d'avant l'activation de l'exportation.

Pour exporter les données de facturation de plusieurs comptes Partner Sales Console, procédez comme suit :

1. Dans l'ensemble de données BigQuery vers lequel vous souhaitez exporter vos données, assurez-vous que les administrateurs de la facturation de chaque compte de la Partner Sales Console sont autorisés à afficher l'ensemble de données.
2. Lorsque vous configurez l'exportation des données de facturation dans chaque compte Partner Sales Console, sélectionnez l'ensemble de données unifié.

Emplacements BigQuery compatibles

BigQuery est compatible avec deux types de régions.

Emplacements multirégionaux

Le tableau suivant répertorie les régions multiples où l'exportation des données BigQuery de Channel Services est disponible.

Régions

Le tableau suivant liste les régions des Amériques où l'exportation des données BigQuery des services de chaîne est disponible.

Le tableau suivant répertorie les régions d'Asie-Pacifique où l'exportation des données BigQuery des services de chaîne est disponible.

Le tableau suivant répertorie les régions d'Europe où l'exportation des données BigQuery Channel Services est disponible.

Activer l'exportation

Avant d'activer l'exportation des données, notez l'ID complet de votre ensemble de données, qui se présente au format PROJECT_ID:DATASET_NAME.

Pour activer l'exportation Channel Services :

1. Dans la Partner Sales Console, ouvrez la page Facturation.
2. Sélectionnez Exportation de la facturation.
3. Saisissez l'ID de l'ensemble de données complet dans le champ Ensemble de données pour la refacturation.
4. Sélectionnez les sources de données pour lesquelles exporter des données.
5. Cliquez sur Mettre à jour. Si vous êtes invité à mettre à jour les autorisations de l'ensemble de données, cliquez sur Mettre à jour.

Une fois configurée, l'exportation de la facturation fournit quotidiennement des données d'utilisation incrémentielle. Le tableau d'exportation ne s'affichera que lorsque l'exportation de la facturation aura été exécutée pour la première fois pour votre compte. L'ensemble de données contient les données depuis sa première configuration pour conserver les données.

Pour arrêter l'exportation des données de coût de refacturation vers l'ensemble de données, cliquez sur Désactiver l'exportation des données de facturation sur la page Refacturation des clients. Pour réactiver l'exportation, suivez les étapes précédentes pour spécifier un ID d'ensemble de données.

Les données de coût de refacturation peuvent ne pas être disponibles pendant la période de désactivation. Si vous avez supprimé des données exportées pendant cette période, nous ne pourrons pas reconstituer les enregistrements supprimés.

Autorisations requises pour le compte de service

L'exportation des données Channel Services utilise un compte de service appartenant à Google, géré par Google et autorisé à écrire des enregistrements de facturation dans une table. Le compte de service est le suivant :

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

Ce compte de service nécessite le rôle prédéfini roles/bigquery.dataEditor pour autoriser les exportations. Vous pouvez configurer les autorisations en suivant les étapes pour activer l'exportation.

Interroger les données de manière efficace

Par défaut, la table BigQuery est partitionnée par export_time et mise en cluster par payer_billing_account_id. Cela signifie que la table est divisée en partitions plus petites, chacune étant elle-même divisée en clusters plus petits. L'utilisation des clés de partition et de clustering dans une requête aidera BigQuery à localiser rapidement les données pertinentes, ce qui peut réduire considérablement le coût de la requête.

Par exemple, cette requête est efficace par rapport à une requête sans clés de partitionnement ni de 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;

Pour en savoir plus sur le partitionnement, le clustering et les bonnes pratiques, consultez les liens suivants :

1. Interroger des tables partitionnées
2. Interroger des tables en cluster
3. Optimiser le calcul des requêtes
4. Bonnes pratiques pour contrôler les coûts dans BigQuery

Trouver l'ID de compte de facturation du payeur

Pour trouver l'ID du compte de facturation du payeur, ouvrez la page des comptes de facturation de la Partner Sales Console, puis cliquez sur l'onglet Facturation partenaire.

Vous pouvez consulter tous les comptes de facturation et les ID de compte de facturation du payeur.

Configurer les contrôles d'accès pour les autres utilisateurs de l'ensemble de données d'exportation

Il existe plusieurs façons de configurer les contrôles d'accès aux données dans l'exportation BigQuery. Pour en savoir plus, consultez la page Contrôle des accès dans BigQuery.

Pour vous assurer que les utilisateurs n'ont accès qu'aux données qu'ils sont autorisés à consulter, nous vous recommandons de configurer des vues autorisées pour partager les données de votre ensemble de données exporté.

Pour l'exportation continue de données, lorsque vous configurez des autorisations pour les utilisateurs, assurez-vous que le compte de service cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com dispose toujours d'un accès complet en tant qu'éditeur à l'ensemble de données d'exportation.

Schéma de la table

Le schéma suivant décrit les données de la table BigQuery.

Dans votre ensemble de données BigQuery, l'exportation de refacturation détaillée est chargée dans une table de données nommée reseller_billing_detailed_export_v1.

Remarques supplémentaires sur le schéma

Voici quelques remarques supplémentaires sur le schéma.

Colonnes non applicables à Google Workspace

Lorsqu'une colonne ou un champ ne s'applique pas à une famille de produits, les données exportées pour cette famille de produits contiennent null dans ce champ. Les champs suivants ne s'appliquent pas aux exportations 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

Colonnes non applicables aux SKU Google Workspace facturés selon la consommation

Lorsqu'une colonne ou un champ ne s'applique pas à une famille de produits, les données exportées pour cette famille de produits contiennent null dans ce champ. Les champs suivants ne s'appliquent pas aux exportations 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

Colonnes non applicables aux commandes hors connexion (aperçu)

Lorsqu'une colonne ou un champ ne s'applique pas à une famille de produits, les données exportées pour cette famille de produits contiennent null dans cette colonne ou ce champ. Les colonnes ou champs suivants ne s'appliquent pas aux exportations de facturation des commandes hors connexion :

• 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

Autres remarques concernant l'exportation Google Workspace

Les exportations Google Workspace présentent plusieurs comportements spéciaux :

• Les données Google Workspace ne contiennent pas la propre utilisation du revendeur.
• Lorsque cost_type est tax et adjustment, usage.amount_in_pricing_units est toujours égal à 1.
• Sur les factures Google Workspace, les taxes sont indiquées sur une seule ligne. Dans l'exportation, les taxes sont ventilées par client. Bien que le montant total des taxes doive correspondre à celui de la facture, il est possible que les taxes individuelles contiennent de légères inexactitudes dues à l'arrondi.

billing_account_id

• Pour Google Cloud, il s'agit du compte de facturation Cloud auquel l'utilisation est associée.
• Pour Google Workspace, il s'agit de l'identité Cloud Identity du client.
• Pour les commandes hors connexion, il s'agit du nom du client.

service et sku

Pour Google Workspace, ces colonnes représentent le "Produit" et le "SKU" associés à l'utilisation. En savoir plus sur les ID de produit et de SKU

Pour les SKU Google Workspace basés sur la consommation (Google Voice et Drive), les colonnes sku.id et service.id contiennent null.

usage_start_time et usage_end_time

Dans le fichier CSV de la facture Google Workspace, cela est représenté par des dates. Dans les exportations, ils sont représentés par des codes temporels :

• Pour usage_start_time, il s'agit de l'heure de début (incluse) de l'abonnement, à 0h PST à la date de début.
• Pour usage_end_time, il s'agit de l'heure de fin (non incluse) de l'abonnement, à 0h PST le lendemain de la date de fin.

project.labels

Pour Google Cloud, il s'agit des paires clé-valeur du projetGoogle Cloud où l'utilisation a eu lieu. Pour en savoir plus, consultez Utiliser des libellés.

labels

Pour Google Cloud, il s'agit des paires clé/valeur sur la ressource Google Cloudoù l'utilisation a eu lieu. Pour en savoir plus, consultez Utiliser des libellés.

system_labels

• Pour Google Cloud, il s'agit des paires clé/valeur sur la ressourceGoogle Cloud où l'utilisation a eu lieu. Pour en savoir plus, consultez Libellés système disponibles.

• Pour Google Workspace, il s'agit de métadonnées supplémentaires concernant le coût, y compris :

  • workspace.googleapis.com/domain_name : nom de domaine du client.
  • workspace.googleapis.com/order_id : ID de la commande.
  • workspace.googleapis.com/purchase_order_id : ID du bon de commande.
  • workspace.googleapis.com/subscription_id : ID de l'abonnement.
  • workspace.googleapis.com/usage_type : type d'utilisation. Non applicable si cost_type n'est pas regular.

Voici les types d'utilisation de Google Workspace :

• COMMITMENT_TERM_START_ITEM : début d'un abonnement. Généralement associé à un mois partiel pour un abonnement avec engagement facturé mensuellement et à la période de facturation ou contractuelle pour un abonnement prépayé.
• COMMITMENT_TERM_END_ITEM : fin d'un abonnement. Généralement associé aux frais du dernier mois d'un abonnement avec engagement facturé mensuellement.
• COMMITMENT_TERM_RENEWAL_ITEM : début d'une période d'abonnement consécutive.
• COMMITMENT_MONTHLY_ITEM : utilisation enregistrée pour les engagements existants au début du mois. Dans la plupart des cas, les frais s'appliquent à l'ensemble du mois.
• COMMITMENT_SEATS_CHANGE_ITEM : enregistré lorsque le niveau d'engagement change (augmentation ou diminution). Elle commence souvent à la mi-mois et se termine à la fin du mois pour un abonnement avec engagement facturé mensuellement, ou à la fin de la période de facturation ou du contrat pour un abonnement prépayé.
• COMMITMENT_CANCEL_ITEM : enregistré lorsqu'un abonnement est résilié. Inclut les frais associés à la résiliation anticipée. Représente soit des frais pour la durée restante du contrat en cas de résiliation en cours de période, soit un crédit émis pour la durée restante de la période de facturation en cas de modification ou de résiliation d'un contrat en cours de période.
• FLEXIBLE_SEATS_ITEM : enregistre l'utilisation par un certain nombre d'utilisateurs pour un bloc contigu d'un certain nombre de jours. Réservé aux utilisateurs sans engagement.
• COUPON_DISCOUNT_ITEM : montant de la remise associée à un bon de réduction.
• MIGRATED_CREDIT_ITEM : crédit issu de la migration de Postini.
• COMMITMENT_PREPAY_BILLING_PERIOD_ITEM : représente une information sur l'utilisation créée au début du cycle de paiement pour l'ensemble du cycle d'un abonnement avec prépaiement et engagement.

usage.amount

Pour l'utilisation de Google Workspace basée sur le nombre d'utilisateurs, il s'agit des licences payantes. Par exemple, les licences avec engagement ou le nombre de licences payées pour les abonnements modulables.

Pour les SKU Google Workspace à consommation (Google Voice et Drive), il s'agit du nombre de minutes utilisées.

usage.pricing_unit

• Pour Google Cloud, découvrez l'API Cloud Billing Catalog. {: track-type="tasks" class="external" track-name="externalLink" track-metadata-position="body"}
• Pour Google Workspace, il s'agit de count.

credits.id

Pour Google Cloud, il s'agit d'un identifiant unique alphanumérique (12-b34-c56-d78) ou d'une description du type de crédit (Remise sur engagement d'utilisation : processeur). Si le champ credits.id est vide, le code SKU du produit n'est pas associé à un crédit.

credits.full_name

Pour Google Cloud, il s'agit d'une description lisible d'un credits.id alphanumérique. Exemples : Crédit d'essai sans frais ou Remise sur engagement d'utilisation basée sur les dépenses. Les valeurs credits.full_name ne sont renseignées que pour les codes SKU avec une propriété credits.id alphanumérique. Si la valeur de credits.id est une description du type de crédit (par exemple, Remise sur engagement d'utilisation : processeur), le champ credits.full_name est vide.

credits.type

Pour Google Cloud, les types de crédits incluent :

• COMMITTED_USAGE_DISCOUNT : contrats d'engagement d'utilisation basés sur les ressources souscrits pour Compute Engine en échange de tarifs réduits pour l'utilisation des VM.
• COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE : contrats d'engagement d'utilisation basés sur les dépenses souscrits pour les services en échange de votre engagement à dépenser un montant minimal.
• DISCOUNT : le type de crédit de la remise est utilisé pour les crédits cumulés lorsqu'un seuil de dépenses contractuel est atteint. Notez que dans les rapports Cloud Billing disponibles dans Partner Sales Console, le type de crédit de la remise est indiqué sous la forme Remises basées sur les dépenses (contractuelles).
• FREE_TIER : certains services permettent l'utilisation gratuite des ressources jusqu'aux limites spécifiées. Pour ces services, des crédits sont appliqués pour rendre leur utilisation gratuite.
• PROMOTION : le type d'avoir promotionnel comprend l'essai gratuitGoogle Cloud et des crédits de campagne marketing ou d'autres subventions pour utiliser Google Cloud. Lorsqu'ils sont disponibles, les avoirs promotionnels sont considérés comme un mode de paiement et sont automatiquement appliqués pour réduire votre facture totale.
• RESELLER_MARGIN : si vous êtes revendeur, le type de crédit marge du revendeur indique les remises du programme Revendeur obtenues pour chaque ligne éligible.
• SUBSCRIPTION_BENEFIT : crédits obtenus en achetant des abonnements à long terme à des services en échange de remises.
• SUSTAINED_USAGE_DISCOUNT : le type de crédit pour les remises automatiques proportionnelles à une utilisation soutenue vous est accordé lorsque vous exécutez des ressources Compute Engine spécifiques pendant une grande partie du mois de facturation.

adjustmentsInfo

Pour Google Cloud, ces valeurs ne sont renseignées que si la ligne de coût a été générée pour une modification Cloud Billing. Le type adjustmentsInfo contient des informations sur l'ajustement, qu'il ait été émis pour corriger une erreur ou pour d'autres raisons.

adjustmentsInfo.adjustment_type

Pour Google Cloud, cela inclut :

• USAGE_CORRECTION : correction effectuée en raison d'une utilisation incorrecte constatée.
• PRICE_CORRECTION : correction effectuée en raison de règles de tarification incorrectes.
• METADATA_CORRECTION : correction permettant de corriger les métadonnées sans modifier le coût.
• GOODWILL : crédit accordé à un client pour sa goodwill.
• SALES_BASED_GOODWILL : crédit accordé au client pour sa goodwill, dans le cadre d'un contrat.
• SLA_VIOLATION : crédit accordé au client en raison d'une violation de l'objectif de niveau de service (SLO).
• BALANCE_TRANSFER : ajustement pour transférer des fonds d'un compte de paiement à un autre.
• ACCOUNT_CLOSURE : ajustement pour appliquer un compte clôturé à un solde nul.
• GENERAL_ADJUSTMENT : modification générale d'un compte de facturation Cloud.

adjustmentsInfo.adjustment_mode

Pour Google Cloud, cela inclut :

• PARTIAL_CORRECTION : la correction annule partiellement l'utilisation et le coût d'origine.
• COMPLETE_NEGATION_WITH_REMONETIZATION : la correction annule complètement l'utilisation et le coût d'origine, et émet les éléments de ligne corrigés en cas d'utilisation et de coûts mis à jour.
• COMPLETE_NEGATION : la correction annule complètement l'utilisation et le coût d'origine. Par ailleurs, aucune autre utilisation n'est plus remonétisée.
• MANUAL_ADJUSTMENT : l'ajustement est alloué manuellement au coût et à l'utilisation.

price.effective_price

Pour Google Cloud, il s'agit du prix facturé pour l'utilisation des SKUGoogle Cloud ou Google Maps Platform et des niveaux de tarification des SKU. Si votre compte de facturation Cloud dispose d'une tarification contractuelle personnalisée, ce prix est spécifique à votre compte de facturation Cloud. Sinon, il s'agit du prix catalogue du SKU ou du niveau du SKU.