Exporter les données Channel Services vers BigQuery

Cette page vous explique comment configurer une exportation Channel Services, ainsi que décrit 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 une analyse détaillée de la façon 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 au revendeur qui ne sont pas incluses dans les exportations Cloud Billing. Cela inclut les coûts, les crédits et l'utilisation avec les règles de calcul des nouveaux tarifs que vous avez configurées. Ces exportations regroupent également des informations sur l'expérience client de facturation parents en 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 pour les non-revendeurs, 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. Vérifiez 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 l'exportation des données Cloud Billing, vous pouvez réutiliser ce projet et cet ensemble de données pour l'exportation Channel Services.

Pour plus d'informations sur la configuration d'un projet et d'un ensemble de données, consultez la section Configurer Exportation des données Cloud Billing vers dans 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 BigQuery pour stocker les données Channel Services. Activer la facturation sur le projet s'il n'est pas déjà activé.

Lorsque vous sélectionnez ou créez BigQuery ensemble de données, vous vous pouvez choisir l'un des emplacements BigQuery compatibles 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 BigQuery ensemble de données pour utiliser un ensemble de données multirégional l'emplacement, Les données BigQuery Export sont disponibles pour chaque donnée 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 dans une région (autre que les États-Unis ou l'UE multirégionaux), vos données d'exportation BigQuery sont disponibles pour chaque source de données sélectionnée à compter de la date à laquelle vous activez 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 : 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

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 de l'Union européenne1 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 répertorie les régions d'Asie-Pacifique où L'exportation de données BigQuery dans Channel Services est possible.

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 de données, notez l'ID de votre ensemble de données complet, qui est 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.

UI permettant d'activer la refacturation Exportations

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 exécutée pour la première fois pour votre compte. L'ensemble de données contient des données depuis sa configuration initiale conserver les 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 la facturation Exportation de données 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 supprimé toutes les données exportées pendant cette période, nous ne pouvons pas reconstituer d'enregistrements.

Autorisations requises pour les comptes de service

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. La compte de service:

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 cluster par payer_billing_account_id par défaut. Cela signifie que le tableau est divisé en partitions plus petites, chacune d'entre elles étant elle-même divisée en clusters plus petits. Utiliser les clés de partitionnement et de cluster dans une requête aident BigQuery à localiser rapidement les données pertinentes, ce qui peut de réduire considérablement le coût de la requête.

Par exemple, la requête ci-dessous 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 et le clustering, ainsi que sur les bonnes pratiques, consultez la 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 d'exportation

Il existe plusieurs façons de configurer des contrôles d'accès aux données dans l'exportation BigQuery. Pour plus d'informations, consultez les Contrôle des accès 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 toujours dispose d'un accès complet en éditeur sur l'ensemble de données d'exportation pour l'exportation continue des 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 celui du client ou le vôtre. 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. Exemple : "202101" est le même qu'en 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 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 valeur/clé (si des libellés sont présents).
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 le project.id.
labels Struct, répété
labels.key Chaîne Clé de la paire valeur/clé (si des libellés sont présents).
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 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 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 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. 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 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 Float 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 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 de REseller_MARGIN, ce montant sera 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. 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 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 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 : 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 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. Ne sera renseigné 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. Pour Par exemple, un SKU avec trois niveaux de tarification : de 0 à 100 unités, de 101 à 1 000 unités, et plus de 1 001 unités, affiche trois lignes de prix pour le SKU : 0, 101, et 1 001 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 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 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

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 contiendra 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 l'utilisation du revendeur.
  • Lorsque cost_type est défini sur tax et adjustment, usage.amount_in_pricing_units est toujours égal à 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 montant total des taxes corresponde à la facture, les taxes individuelles peuvent contenir des erreurs d'arrondi mineures.

billing_account_id

  • Pour Google Cloud, il s'agit du compte de facturation Cloud dont l'utilisation est associée.
  • Pour Google Workspace, il s'agit de l'ID Cloud Identity clientèle.

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 d'article

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 Projet Google Cloud dans lequel 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 Ressource Google Cloud dans laquelle l'utilisation a eu lieu. Pour plus d'informations, consultez la section Système étiquettes.

  • Pour Google Workspace, il s'agit de métadonnées supplémentaires concernant qui comprend:

    • 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 de la commande d'achat (PO).
    • 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 quelques exemples de types d'utilisation de Google Workspace :

  • COMMITMENT_TERM_START_ITEM : début d'un abonnement. Habituellement associées à 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 les 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, le débit s'étendra sur tout le mois.
  • COMMITMENT_SEATS_CHANGE_ITEM : enregistré lorsque le niveau d'engagement change (augmentation ou diminution). Débute souvent en milieu de mois et s'étend jusqu'à la fin du mois pour un abonnement avec engagement facturé mensuellement ou jusqu'à la fin du mois de la période de facturation/contrat pour un abonnement avec prépaiement.
  • 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 correspondant au reste de la période du contrat lorsque celui-ci est résilié. en cours de route ou un avoir émis pour le reste de la période de facturation lorsqu'un contracté est modifié ou annulé en cours de route.
  • FLEXIBLE_SEATS_ITEM : enregistre l'utilisation par un certain nombre d'utilisateurs pour un bloc contigu d'un certain nombre de jours. Actuellement, réservée 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 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 une utilisation basée sur le nombre de licences 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

credits.id

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

credits.type

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

  • COMMITTED_USAGE_DISCOUNT: Les contrats d'engagement d'utilisation basés sur les ressources ont été souscrits pour Compute Engine dans les pays suivants : vous pouvez bénéficier de remises conséquentes sur 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 la console Ventes partenaires, 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. Des crédits sont appliqués pour rendre gratuite l'utilisation de ces services.
  • PROMOTION: le type d'avoir promotionnel inclut Google Cloud Free Essai 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 aux services en échange de remises.
  • SUSTAINED_USAGE_DISCOUNT Le type de crédit "Remise automatique proportionnelle à une utilisation soutenue" est une remise automatique en exécutant des ressources Compute Engine spécifiques 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é pour une modification de Cloud Billing. adjustmentsInfo contient des informations sur l'ajustement et indique s'il a été émis pour correction une erreur ou 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 paramètre les coûts.
  • GOODWILL : crédit accordé à un client pour sa goodwill.
  • SALES_BASED_GOODWILL: un crédit accordé au client pour sa clientèle, au titre de 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: un ajustement visant à transférer de l'argent à partir 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.

adjustmentsInfo.adjustment_mode

Pour Google Cloud, cela inclut:

  • PARTIAL_CORRECTION: la correction annule partiellement l'utilisation d'origine. et les coûts.
  • 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 entièrement l'utilisation d'origine. et aucune autre utilisation 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 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, il s'agit du prix spécifique au compte de facturation. Sinon, il s'agit du prix catalogue du SKU ou du niveau du SKU.