Exporter les données Channel Services vers BigQuery

Cette page vous explique comment configurer une exportation Channel Services 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écifié. Ces données peuvent vous aider à effectuer une analyse détaillée de la manière dont vos clients ou partenaires de distribution utilisent les services que vous fournissez.

Les exportations à partir de Channel Services contiennent des données spécifiques aux revendeurs qui ne sont pas incluses dans les exportations Cloud Billing. Cela inclut les coûts, les crédits et les données d'utilisation avec vos règles de refacturation configurées. Ces exportations regroupent é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 également 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 revendeurs, consultez la page 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 sur le projet.
  • Activer l'API du service de transfert de données BigQuery sur 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 la page 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:

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 Channel Services. 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 acceptés pour l'ensemble de données. Lorsque vous activez l'exportation de 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 BigQuery Export le 23 septembre, votre exportation inclura les données à partir du 1er août.

  • Si vous configurez votre ensemble de données BigQuery pour utiliser un emplacement régional (autre qu'un emplacement multirégional US ou EU), 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 avant l'activation de l'exportation.

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

  1. Sur 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 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

Emplacements multirégionaux

Le tableau suivant répertorie les emplacements multirégionaux dans lesquels l'exportation de données BigQuery de Channel Services est disponible.

Description de la zone multirégionale Nom de la zone multirégionale
Centres de données dans les États membres de l'Union européenne1 EU
Centres de données aux États-Unis US

Régions

Le tableau suivant répertorie les régions des Amériques dans lesquelles l'exportation de données BigQuery Channel Services est disponible.

Description de la région Nom de la région
Iowa us-central1
Las Vegas us-west4
Los Angeles us-west2
Montréal northamerica-northeast1
Virginie du Nord us-east4
Oregon us-west1
Salt Lake City us-west3
São Paulo southamerica-east1
Caroline du Sud us-east1

Le tableau suivant répertorie les régions d'Asie-Pacifique dans lesquelles l'exportation de données BigQuery Channel Services est disponible.

Description de la région Nom de la région
Hong Kong asia-east2
Jakarta asia-southeast2
Mumbai asia-south1
Osaka asia-northeast2
Séoul asia-northeast3
Singapour asia-southeast1
Sydney australia-southeast1
Taïwan asia-east1
Tokyo asia-northeast1

Le tableau suivant répertorie les régions d'Europe dans lesquelles l'exportation de données BigQuery Channel Services est disponible.

Description de la région Nom de la région
Belgique europe-west1
Finlande europe-north1
Francfort europe-west3
Londres europe-west2
Pays-Bas europe-west4
Varsovie europe-central2
Zurich europe-west6

Activer l'exportation

Avant d'activer l'exportation de données, notez l'ID de votre ensemble de données complet, 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 Update (Mettre à jour). Si vous êtes invité à mettre à jour les autorisations de l'ensemble de données, cliquez sur Mettre à jour.

UI permettant d'activer les exportations de refacturation

Une fois configurée, l'exportation de la facturation fournit quotidiennement des données d'utilisation incrémentielles. La table d'exportation ne s'affiche pas tant que l'exportation de la facturation n'a pas été exécutée pour votre compte pour la première fois. L'ensemble de données contient des données provenant de la date à laquelle il a été configuré pour conserver des données.

Pour arrêter d'exporter les 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 du client. Pour réactiver l'exportation, spécifiez un ID d'ensemble de données en suivant les étapes précédentes.

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

Autorisations de compte de service requises

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

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 la procédure permettant d'activer l'exportation.

Interroger les données efficacement

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

Par exemple, la requête ci-dessous est plus efficace qu'une requête sans clés de partitionnement et 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 et le clustering, ainsi que sur les bonnes pratiques à suivre, 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 du compte de facturation du payeur

Pour trouver l'ID du compte de facturation du payeur, ouvrez la page Comptes de facturation de la console Ventes partenaires, puis cliquez sur l'onglet Facturation partenaire.

Vous pouvez voir tous les comptes de facturation et les ID des comptes de facturation payants.

ID du 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 BigQuery Export. Pour en savoir plus, consultez la page Contrôles 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é.

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 éditeur sur l'ensemble de données d'exportation pour une exportation continue de données.

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 la refacturation détaillée est chargée dans une table de données nommée reseller_billing_detailed_export_v1.

Champ Type Description
billing_account_id Chaîne ID du compte auquel l'utilisation est associée, qui peut être le vôtre ou celui du client. Selon la famille de produits, il peut s'agir d'un compte de facturation ou d'un ID Cloud Identity.
payer_billing_account_id Chaîne ID de votre compte de facturation parent.
invoice.month Chaîne Année et mois (AAAAMM) de la facture qui inclut les lignes de coûts. Par exemple, "202101" est identique à janvier 2021.
cost_type Chaîne Type de coût représenté par cette ligne : erreur standard, de taxe, d'ajustement ou d'arrondi.
service.id Chaîne ID du service auquel l'utilisation est associée.
service.description Chaîne Le service Google qui a enregistré les données de facturation.
sku.id Chaîne ID SKU de la ressource utilisée par le service.
sku.description Chaîne Description du type de ressource utilisé par le service. Par exemple, Cloud Storage est de type Stockage standard aux États-Unis.
usage_start_time Code temporel Heure de début de la période d'utilisation horaire du coût calculé. L'utilisation et les coûts de tous les services sont affichés avec une précision horaire. L'utilisation du service de longue durée est répartie sur plusieurs périodes horaires. Il s'agit du début du mois de facturation pour les produits sur abonnement.
usage_end_time Code temporel Heure de fin de la période d'utilisation horaire du coût calculé. L'utilisation et les coûts de tous les services sont affichés avec une précision horaire. L'utilisation du service de longue durée est répartie sur plusieurs périodes horaires. Il s'agit de la fin du mois de facturation pour les produits sur abonnement.
project Struct Informations sur le projet Google Cloud ayant généré les données Cloud Billing.
project.number Chaîne Identifiant unique, anonymisé et généré en interne pour le projet Google Cloud ayant généré les données Cloud Billing.
project.id Chaîne ID du projet Google Cloud ayant généré les données Cloud Billing.
project.name Chaîne Nom du projet Google Cloud ayant généré les données Cloud Billing.
project.labels Struct, répété
project.labels.key Chaîne Clé de la paire clé-valeur (si des libellés sont présents).
project.labels.value Chaîne Valeur de la paire clé-valeur (si des libellés sont présents).
project.ancestry_numbers Chaîne Ancêtres de la hiérarchie des ressources pour le projet identifié par le project.id.
labels Struct, répété
labels.key Chaîne Clé de la paire clé-valeur (si des libellés sont présents).
labels.value Chaîne Valeur de la paire clé-valeur (si des libellés sont présents).
system_labels Struct, répété
system_labels.key Chaîne Clé de la paire valeur/clé (si des libellés système sont présents)
system_labels.value Chaîne Valeur de la paire clé-valeur (si des libellés système sont présents).
location.location Chaîne Lieu d'utilisation au niveau d'un pays, d'une région ou d'une zone. Affiche global pour les ressources sans emplacement spécifique. Pour en savoir plus, consultez la page Régions et zones.
location.country Chaîne Lorsque location.location est un pays, une région ou une zone, ce champ correspond au pays d'utilisation. Exemple :US Pour en savoir plus, consultez la page Régions et zones.
location.region Chaîne Lorsque location.location est un pays ou une région, ce champ correspond à la région d'utilisation. Exemple :us-central1 Pour en savoir plus, consultez la page Régions et zones.
location.zone Chaîne Lorsque location.location est une zone, ce champ correspond à la zone d'utilisation. Exemple :us-central1-a Pour en savoir plus, consultez la page Régions et zones.
resource Struct Décrit la structure et la valeur des informations pertinentes sur les ressources de service (par exemple, les machines virtuelles ou un SSD) qui génèrent l'utilisation du service.
resource.name Chaîne Identifiant spécifique au service pour la ressource qui a généré une utilisation pertinente. Peut être générée par l'utilisateur.
resource.global_name Chaîne Identifiant de service unique pour la ressource qui a généré une utilisation pertinente.
cost Numérique Coût d'utilisation avant tout crédit appliqué. Pour obtenir le coût total, crédits inclus, ajoutez credits.amount à cost.
currency Chaîne Devise de facturation du coût. Pour en savoir plus, consultez Devise locale pour la facturation et les paiements.
currency_conversion_rate Nombre à virgule flottante Le taux de change du dollar américain dans la devise locale. Autrement dit, cost ÷ currency_conversion_rate est égal au coût en dollars américains.
usage.amount Numérique Quantité d'usage.unit utilisée.
usage.unit Chaîne Unité de base pour mesurer l'utilisation des ressources. Par exemple, l'unité de base pour le stockage standard est l'octet par seconde.
usage.amount_in_pricing_unit Numérique Quantité d'utilisation de usage.pricing_unit.
usage.pricing_unit Chaîne Unités permettant de mesurer l'utilisation des ressources.
credits Struct, répété Contient des champs qui décrivent la structure et la valeur des crédits.
credits.id Chaîne Si ce champ est renseigné, il indique qu'un crédit est associé au SKU du produit.
credits.full_name Chaîne Le nom du crédit associé au code SKU du produit.
credits.type Chaîne Ce champ décrit l'objectif ou l'origine de l'objet credits.id.
credits.name Chaîne Description du crédit appliqué à l'utilisation.
credits.amount Numérique Le montant du crédit appliqué à l'utilisation.
credits.channel_partner_amount Numérique Montant du crédit appliqué à l'utilisation, après majorations de la refacturation et remises. Basé sur le channel_partner_name et la ChannelPartnerRepricingConfig associée. Si credits.type est de RESTORE_MARGIN, ce montant sera nul.
credits.customer_amount Numérique Montant du crédit appliqué à l'utilisation, après majorations de la refacturation et remises. Basé sur le customer_name et la CustomerRepricingConfig associée. Si credits.type est de RESTORE_MARGIN, ce montant sera nul.
adjustmentsInfo Struct, répété Contient des champs qui décrivent la structure et la valeur d'un ajustement des éléments de campagne associés au coût.
adjustmentsInfo.adjustment_id Chaîne S'il est renseigné, un ajustement est associé à une ligne de coût. adjustmentsInfo.adjustments_id est l'identifiant unique de tous les ajustements causés par un problème.
adjustmentsInfo.adjustment_description Chaîne Description de l'ajustement et de sa cause.
adjustmentsInfo.adjustment_type Chaîne Type d'ajustement.
adjustmentsInfo.adjustment_mode Chaîne La manière dont l'ajustement a été émis.
export_time Code temporel Le temps de traitement associé à l'ajout de données de facturation. Cette valeur augmente toujours à chaque nouvelle exportation. Utilisez la colonne export_time pour déterminer quand les données de facturation exportées ont été mises à jour pour la dernière fois.
entitlement_name Chaîne Nom de ressource du droit de l'API Cloud Channel. Utilise le format suivant: accounts/{account}/customers/{customer}/entitlements/{entitlement}
channel_partner_name Chaîne (Distributeurs uniquement) Nom de ressource du partenaire de distribution qui vend au client final. Utilise le format suivant: accounts/{account}/channelPartnerLinks/{channelPartner}.
channel_partner_cost Numérique (Distributeurs uniquement) Coût revenant au partenaire de distribution, identifié par channel_partner_name, après l'application d'un ChannelPartnerRepricingConfig existant.
customer_name Chaîne Nom de la ressource du client du revendeur qui a consommé cette utilisation au format accounts/{account}/customers/{customer}
customer_cost Numérique Coût facturé au client du revendeur identifié par la colonne customer_name, après l'application de la valeur CustomerRepricingConfig, le cas échéant.
cost_at_list Numérique Coût s'il est facturé avec la tarification publique.
customer_repricing_config_name Chaîne Nom de ressource de l'API Cloud Channel CustomerRepricingConfig. Utilise le format suivant: accounts/{account}/customers/{customer}/customerRepricingConfigs/{id}.
channel_partner_repricing_config_name Chaîne (Distributeurs uniquement) Nom de ressource de l'API Cloud Channel ChannelPartnerRepricingConfig. Utilise le format suivant: accounts/{account}/channelPartnerLinks/{channelPartner}/channelPartnerRepricingConfigs/{id}.
tags Struct Champs décrivant le tag, tels que la clé, la valeur et l'espace de noms.
tags.key Chaîne Nom court ou nom à afficher de la clé associée à ce tag.
tags.value Chaîne Ressources associées à une clé de tag. À tout moment, une seule valeur peut être associée à une ressource pour une clé donnée.
tags.inherited Booléen Indique si une liaison de tag est héritée (tags hérités = True) ou directe/non héritée (tags hérités = False).
tags.namespace Chaîne Représente la hiérarchie des ressources qui définit les clés et les valeurs de tag. L'espace de noms peut être associé à des noms courts de clé de tag et de valeur de tag pour créer un nom complet et unique pour la clé de tag ou la valeur de tag.
customer_correlation_id Chaîne ID CRM externe du client. Renseigné uniquement si un ID CRM existe pour ce client.
price Struct Champs qui décrivent la structure et la valeur liées aux prix facturés pour l'utilisation.
price.effective_price Numérique Montant facturé pour l'utilisation.
price.tier_start_amount Numérique Limite inférieure du nombre d'unités pour le niveau de tarification d'un SKU. Par exemple, un SKU comportant trois niveaux de tarification (par exemple, 0 à 100 unités, 101 à 1 000 unités et 1 001 unités et plus) affichera trois lignes de tarification pour le SKU, où 0, 101 et 1001 dans le champ price.tier_start_amount représentant la quantité unitaire de départ pour les niveaux de tarification du SKU. En savoir plus sur les niveaux de tarification de Google Cloud
price.unit Chaîne Unité d'utilisation dans laquelle la tarification est spécifiée et l'utilisation des ressources est mesurée (par exemple, gibioctet, tébioctet, mois, année, gibioctet-heure, gibioctet/mois ou nombre). La valeur du champ price.unit correspond à celle du champ usage.pricing_unit.
price.pricing_unit_quantity Numérique Quantité d'unités du niveau de tarification des SKU. Par exemple, si le prix du niveau est de 1 $pour 1 000 000 octets, cette colonne affichera 1 000 000.
transaction_type Chaîne Type de transaction du vendeur. Le type de transaction peut être l'un des suivants :
  • GOOGLE = 1 : services vendus par Google Cloud.
  • THIRD_PARTY_RESELLER = 2 : services tiers revendus par Google Cloud.
  • THIRD_PARTY_AGENCY = 3: services tiers vendus par un partenaire, avec l'agent Google Cloud.
seller_name Chaîne Nom légal du vendeur.
subscription Struct Champs décrivant vos engagements basés sur les dépenses ou les ressources. Vous pouvez utiliser ces champs afin d'analyser vos frais pour des engagements spécifiques.
subscription.instance_id Chaîne ID d'abonnement associé à un engagement.

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 l'attribut null dans cette colonne/ce champ. Les colonnes/champs suivants ne s'appliquent pas aux exportations 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

Autres remarques sur l'exportation Google Workspace

Les exportations Google Workspace offrent plusieurs comportements spéciaux:

  • Les données Google Workspace ne contiennent pas les données d'utilisation propres au revendeur.
  • Lorsque cost_type est défini sur tax et que adjustment, usage.amount_in_pricing_units est toujours défini sur 1.
  • Sur les factures Google Workspace, les taxes sont indiquées sur une ligne. Dans l'exportation, les taxes sont réparties par client. Bien que le total des taxes corresponde à celui de la facture, les taxes individuelles peuvent présenter de légères inexactitudes d'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'ID Cloud Identity du client.

service et sku

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

usage_start_time et usage_end_time

Dans le fichier CSV de la facture Google Workspace, ces informations sont représentées 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 le jour de début.
  • Pour usage_end_time, il s'agit de l'heure de fin (exclue) de l'abonnement, à 0h PST le jour suivant la date de fin.

project.labels

Pour Google Cloud, il s'agit des paires clé/valeur du projet Google Cloud dans lequel l'utilisation a eu lieu. Pour en savoir plus, consultez la page Utiliser des libellés.

labels

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

system_labels

  • Pour Google Cloud, il s'agit des paires clé/valeur de la ressource Google Cloud concernée par l'utilisation. Pour en savoir plus, consultez la section Libellés système disponibles.

  • Pour Google Workspace, il s'agit de métadonnées supplémentaires concernant le coût, qui incluent les éléments suivants:

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

Voici les différents 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 pour la période de facturation/contrat pour un abonnement avec prépaiement.
  • 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, ces frais sont facturés sur l'ensemble du mois.
  • COMMITMENT_SEATS_CHANGE_ITEM: enregistré lorsque le niveau d'engagement change (augmente ou diminue). L'abonnement commence souvent en milieu de mois et se prolonge en fin de mois pour un abonnement avec engagement facturé mensuellement, ou jusqu'à la fin de la période de facturation ou du contrat pour un abonnement avec prépaiement.
  • COMMITMENT_CANCEL_ITEM: enregistré lors de la résiliation d'un abonnement. Inclut les frais associés à la résiliation anticipée. Représente soit des frais pour le reste de la période du contrat lorsque le contrat est annulé en cours de route, soit un crédit émis pour le reste de la période de facturation lorsqu'un contrat est modifié ou annulé en cours de route.
  • FLEXIBLE_SEATS_ITEM: enregistre l'utilisation pour un certain nombre d'utilisateurs pour un bloc contigu d'un certain nombre de jours. Actuellement destiné uniquement aux utilisateurs sans engagement.
  • COUPON_DISCOUNT_ITEM: montant de la remise associée à un bon de réduction.
  • MIGRATED_CREDIT_ITEM: crédit de la migration Postgres.
  • COMMITMENT_PREPAY_BILLING_PERIOD_ITEM: représente les informations d'utilisation créées au début du cycle de paiement pour l'ensemble du cycle d'un abonnement avec prépaiement.

usage.amount

Pour une utilisation basée sur le nombre de licences Google Workspace, il s'agit des licences payantes. (par exemple, le nombre de licences souscrites pour les engagements ou le nombre de licences payées pour les forfaits modulables).

usage.pricing_unit

credits.id

Pour Google Cloud, il s'agit d'un identifiant alphanumérique unique (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 gratuit ou Remise sur engagement d'utilisation basée sur les dépenses. Les valeurs credits.full_name ne sont renseignées que pour les SKU ayant un credits.id alphanumérique. Si la valeur de credits.id est une description du type de crédit (telle que Remise sur engagement d'utilisation : processeur), le champ credits.full_name sera vide.

credits.type

Pour Google Cloud, les types de crédits sont les suivants:

  • COMMITTED_USAGE_DISCOUNT : contrats d'engagement d'utilisation basé sur les ressources souscrits pour Compute Engine en échange de remises importantes sur l'utilisation des VM.
  • COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE : contrats d'engagement d'utilisation basé sur les dépenses souscrits pour des 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 gagnés après avoir atteint un seuil de dépenses contractuel. Notez que dans les rapports Cloud Billing disponibles dans la 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 implémenter la version gratuite.
  • PROMOTION: le type d'avoir promotionnel comprend l'essai gratuit de Google Cloud, ainsi que 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 un revendeur, le type de crédit marge du revendeur indique les remises du programme Revendeur obtenues pour chaque élément de campagne é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 de remise automatique proportionnelle à une utilisation soutenue est une remise automatique que vous bénéficiez 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 de Cloud Billing. Le type adjustmentsInfo contient des détails 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 due à une utilisation incorrecte signalée.
  • PRICE_CORRECTION: correction due à des 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 clientèle, dans le cadre d'un contrat.
  • SLA_VIOLATION: un crédit accordé au client en raison d'un non-respect d'un objectif de niveau de service (SLO).
  • BALANCE_TRANSFER: ajustement permettant de transférer des fonds d'un compte de paiement à un autre.
  • ACCOUNT_CLOSURE: ajustement visant à remettre un compte clôturé à zéro
  • GENERAL_ADJUSTMENT: modification générale d'un compte de facturation.

adjustmentsInfo.adjustment_mode

Pour Google Cloud, cela inclut:

  • PARTIAL_CORRECTION: la correction annule partiellement l'utilisation et les coûts d'origine.
  • COMPLETE_NEGATION_WITH_REMONETIZATION: la correction annule entièrement l'utilisation et les coûts d'origine, et génère un ou plusieurs éléments de campagne corrigés avec une utilisation et un coût mis à jour.
  • COMPLETE_NEGATION: la correction annule entièrement l'utilisation et les coûts d'origine, et aucune utilisation ultérieure n'est 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 SKU et des niveaux de tarification des SKU Google Cloud ou Google Maps Platform. Si votre compte de facturation Cloud dispose d'un contrat personnalisé, il s'agit du tarif propre à votre compte de facturation. Sinon, il s'agit du prix catalogue du SKU ou du niveau de SKU.