Exporter des données Channel Services vers BigQuery

Cette page explique comment configurer une exportation de services de canaux et décrit également le schéma disponible pour une exportation.

Avec BigQuery, vous pouvez 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 façon dont vos clients ou partenaires de distribution utilisent les services que vous proposez.

Les exportations de Channel Services contiennent des données spécifiques au revendeur 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 repricing configurées. Ces exportations regroupent également toutes les informations sur les comptes de facturation parent 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 revendeur, consultez la section 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.
  • 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 réutiliser ce projet et cet ensemble de données 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 avez besoin des rôles suivants:

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

Dans 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 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 [BigQuery

    Si vous configurez un emplacement multirégional pour votre ensemble de données, 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 [BigQuery

    Si vous configurez un 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 à compter 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 d'avoir activé 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 facturation de chaque compte Partner Sales Console disposent des autorisations nécessaires pour 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 accepte deux types de régions.

Emplacements multirégionaux

Le tableau suivant répertorie les multirégions où l'exportation de données BigQuery Channel Services est prise en charge.

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

Régions

Le tableau suivant liste les régions des Amériques où l'exportation de données BigQuery via les services de canaux 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 liste les régions d'Asie-Pacifique où l'exportation de données BigQuery via les services de canaux 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 où l'exportation de données BigQuery Channel Services est prise en charge.

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 des données, notez l'ID de l'ensemble de données complet, qui se présente sous la forme PROJECT_ID:DATASET_NAME.

Pour activer l'exportation Channel Services:

  1. Dans 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*.

UI for enabling Rebilling exports

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 sera effectuée pour la première fois pour votre compte. L'ensemble de données contient les données de la date à laquelle il a été configuré 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 les comptes 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:

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. Pour configurer les autorisations, suivez la procédure permettant d'activer l'exportation.

Interroger les données de manière efficace

La table BigQuery est partitionnée par export_time et mise en clusters par payer_billing_account_id par défaut. Cela signifie que la table est divisée en partitions plus petites, chacune étant divisée en clusters plus petits. L'utilisation des clés de partition 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, cette requête est efficace par rapport à 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, 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 du 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 voir tous les comptes de facturation et les ID des comptes de facturation des payeurs.

ID du compte de facturation du payeur

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

Il existe plusieurs façons de configurer des 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 des 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 éditeur complet sur 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 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 celui du client ou le vôtre. Selon la famille de produits, il peut s'agir d'un compte de facturation ou d'un compte 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" correspond à 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 Horodatage 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 s'affichent selon un horaire précis. L'utilisation des services pour des opérations 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 Horodatage Heure de fin de la période d'utilisation horaire du coût calculé. L'utilisation et les coûts de tous les services s'affichent selon un horaire précis. L'utilisation des services pour des opérations 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 qui a 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 En cas de présence de libellés, la partie clé de la paire clé-valeur.
project.labels.value Chaîne En cas de présence de libellés, la partie valeur de la paire clé-valeur.
project.ancestry_numbers Chaîne Ancêtres de la hiérarchie des ressources pour le projet identifié par project.id.
labels Struct, répété
labels.key Chaîne En cas de présence de libellés, la partie clé de la paire clé-valeur.
labels.value Chaîne En cas de présence de libellés, la partie valeur de la paire clé-valeur.
system_labels Struct, répété
system_labels.key Chaîne En cas de présence de libellés système, la partie clé de la paire clé-valeur.
system_labels.value Chaîne En cas de présence de libellés système, la partie valeur de la paire clé-valeur.
location.location Chaîne Emplacement de l'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 correspondant aux ressources de service (par exemple, des 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. peuvent être générés par les utilisateurs ;
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 de l'utilisation avant l'application des crédits. 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 Float Le taux de change du dollar américain dans la devise locale. Autrement dit, cost ÷ currency_conversion_rate correspond 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'usage.pricing_unit utilisée.
usage.pricing_unit Chaîne Unités de mesure de 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é, cela signifie qu'un crédit est associé au code 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 application des majorations de refacturation et des remises. En fonction du channel_partner_name et du ChannelPartnerRepricingConfig associé. Si credits.type est RESELLER_MARGIN, ce montant est nul.
credits.customer_amount Numérique Montant du crédit appliqué à l'utilisation, après application des majorations de refacturation et des remises. En fonction du customer_name et du CustomerRepricingConfig associé. Si credits.type est RESELLER_MARGIN, ce montant est nul.
adjustmentsInfo Struct, répété Contient des champs qui décrivent la structure et la valeur d'un ajustement pour les éléments de ligne de coût.
adjustmentsInfo.adjustment_id Chaîne Si ce champ est renseigné, un ajustement est associé à un élément de 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 Horodatage Le temps de traitement associé à l'ajout de données de facturation. Cette valeur augmente toujours à chaque nouvelle exportation. La colonne export_time permet de savoir quand les données de facturation exportées ont été mises à jour pour la dernière fois.
entitlement_name Chaîne Nom de la ressource du droit d'accès 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: accounts/{account}/channelPartnerLinks/{channelPartner}.
channel_partner_cost Numérique (Distributeurs uniquement) Coût pour le partenaire de distribution, identifié par channel_partner_name, après application d'un ChannelPartnerRepricingConfig existant.
customer_name Chaîne Nom de la ressource du client du revendeur qui a consommé cette ressource au format accounts/{compte}/customers/{client}
customer_cost Numérique Coût facturé au client du revendeur identifié par la colonne customer_name, après application de la valeur CustomerRepricingConfig, le cas échéant.
cost_at_list Numérique Coût si le tarif public a été appliqué.
customer_repricing_config_name Chaîne Nom de la ressource de l'CustomerRepricingConfig de l'API Cloud Channel. Utilise le format: accounts/{account}/customers/{customer}/customerRepricingConfigs/{id}.
channel_partner_repricing_config_name Chaîne (Distributeurs uniquement) Nom de la ressource de l'API Cloud Channel ChannelPartnerRepricingConfig. Utilise le format: 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 Les 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 combiné à la clé de tag et aux noms courts de valeur de tag afin de créer un nom complet unique pour la clé de tag ou la valeur de tag.
customer_correlation_id Chaîne ID CRM externe du client. Cette valeur n'est renseignée que 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, tels que "1 à 100 unités", "101 à 1 000 unités" et "1 001 unités et plus", affiche trois lignes de tarification pour le SKU, avec "0", "101" et "1 001" dans le champ price.tier_start_amount représentant la quantité d'unités de départ pour les niveaux de tarification des 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 la tarification du niveau est de 1 $pour 1 000 000 octets, cette colonne indiquera 1 000 000.
transaction_type Chaîne Type de transaction du vendeur. Il peut s'agir de l'un des types de transactions 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 Google Cloud agissant en tant qu'agent.
seller_name Chaîne Nom légal du vendeur.
subscription Struct Champs qui décrivent 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

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
  • transaction_type
  • seller_name

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
  • transaction_type
  • seller_name

Autres remarques concernant l'exportation Google Workspace

Les exportations Google Workspace présentent plusieurs comportements particuliers:

  • Les données Google Workspace ne contiennent pas l'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 affichées sur une seule ligne. Lors de l'exportation, les taxes sont ventilées par client. Bien que le montant total des taxes doit correspondre à la facture, les taxes individuelles peuvent contenir 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'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 les attributs "Produit" 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 (inclusive) de l'abonnement, à 0h00 PST à la date de début.
  • Pour usage_end_time, il s'agit de l'heure de fin (exclusive) de l'abonnement, à 0h00 PST le lendemain de la date de fin.

project.labels

Pour Google Cloud, il s'agit des paires clé-valeur du projet Google Cloud où l'utilisation a eu lieu. Pour en savoir plus, consultez la section 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 section Utiliser des libellés.

system_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 section Libellés système disponibles.

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

    • 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 de la commande d'achat (PO).
    • 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.

Les types d'utilisation de Google Workspace incluent les suivants:

  • COMMITMENT_TERM_START_ITEM: début d'un abonnement. Généralement associé à un mois partiel pour un abonnement avec engagement mensuel et pour la période de facturation ou contractuelle d'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 supplémentaire.
  • COMMITMENT_MONTHLY_ITEM: utilisation enregistrée pour les engagements existants au début du mois. Dans la plupart des cas, les frais s'étendent sur tout le mois.
  • COMMITMENT_SEATS_CHANGE_ITEM: enregistré lorsque le niveau d'engagement change (augmentation ou diminution). Elle commence souvent au milieu du mois et se termine à la fin du mois pour un abonnement avec engagement mensuel ou jusqu'à 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 anticipée, soit un crédit émis pour la durée restante de la période de facturation en cas de modification ou de résiliation anticipée du contrat.
  • 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 de la migration Postini.
  • COMMITMENT_PREPAY_BILLING_PERIOD_ITEM: représente des informations d'utilisation créées au début du cycle de paiement pour l'ensemble du cycle pour un abonnement prépayé avec engagement.

usage.amount

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

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 alphanumérique unique (12-b34-c56-d78) ou d'une description du type de crédit (Remise sur engagement d'utilisation: CPU). 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 par l'humain d'une valeur alphanumérique de credits.id. 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 des 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 proposent l'utilisation gratuite des ressources jusqu'aux limites spécifiées. Des crédits sont appliqués pour rendre gratuite l'utilisation de ces services.
  • PROMOTION: le type d'avoir promotionnel comprend l'essai gratuit de Google 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 é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 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 signalé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'un non-respect du contrat de niveau de service (SLO, Service Level Objective).
  • BALANCE_TRANSFER: ajustement du transfert de 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 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 modifiés.
  • 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 SKU Google 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 facturation Cloud. Sinon, il s'agit du prix catalogue du SKU ou du niveau du SKU.