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.

À l'aide de BigQuery, vous pouvez exporter des données de facturation Channel Services vers un ensemble de données BigQuery spécifié. Ces données peuvent vous aider à analyser en détail la manière dont vos clients ou partenaires de distribution utilisent les services que vous proposez.

Les exportations à partir de Channel Services contiennent des données spécifiques au revendeur qui ne sont pas autrement incluses dans les exportations Cloud Billing. Cela inclut les coûts, les crédits et les données d'utilisation associés aux règles de calcul des nouveaux tarifs que vous avez 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, et 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 hors revendeur, consultez la page Configurer les exportations Cloud Billing vers BigQuery.

Avant de commencer

Avant d'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 elle n'est pas déjà activée.

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

  • Si vous configurez votre ensemble de données BigQuery pour qu'il utilise 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 qu'il utilise un emplacement régional (autre que l'emplacement multirégional des États-Unis ou de 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 de manière rétroactive pour les emplacements d'ensembles de données non multirégionaux. Par conséquent, les données d'exportation BigQuery avant d'activer l'exportation ne s'affichent pas.

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 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 acceptés

Emplacements multirégionaux

Le tableau suivant répertorie les emplacements multirégionaux dans lesquels l'exportation des 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 où l'exportation des données BigQuery de 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 où l'exportation des données BigQuery de 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 où l'exportation des données BigQuery de 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 complet de votre ensemble de données, au format 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 complet de l'ensemble de données dans le champ Ensemble de données pour la refacturation.
  4. Sélectionnez les sources de données pour lesquelles vous souhaitez exporter les 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. Le tableau d'exportation ne s'affichera pas tant que l'exportation de la facturation n'aura pas été effectuée pour la première fois pour votre compte. L'ensemble de données contient des données depuis sa première configuration pour conserver des 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 être indisponibles pendant la durée de 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 efficacement les données

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 étant divisée en clusters plus petits. L'utilisation des clés de partitionnement et de clustering 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 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 Comptes de facturation de la Partner Sales Console, puis cliquez sur l'onglet Facturation partenaire.

Vous pouvez afficher tous les comptes de facturation et les ID des comptes de facturation du payeur.

ID du compte de facturation du payeur

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

Il existe plusieurs façons de configurer le contrôle des 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 afin de partager les données de votre ensemble de données exporté.

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

Champ Type Description
billing_account_id Chaîne Numéro du compte auquel l'utilisation est associée (il peut s'agir du vôtre ou de 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" 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 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 des services 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 des services 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 La partie clé de la paire clé/valeur, si des libellés sont présents.
project.labels.value Chaîne La partie valeur de la paire clé-valeur, si des étiquettes sont présentes.
project.ancestry_numbers Chaîne Ancêtres de la hiérarchie des ressources du projet identifié par le project.id.
labels Struct, répété
labels.key Chaîne La partie clé de la paire clé/valeur, si des libellés sont présents.
labels.value Chaîne La partie valeur de la paire clé-valeur, si des étiquettes sont présentes.
system_labels Struct, répété
system_labels.key Chaîne La partie clé de la paire clé/valeur, 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. Par 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. Par 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. Par 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 pour 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é 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 l'application des crédits. Pour obtenir le coût total, crédits compris, 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 permettant de 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 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 les majorations de refacturation et les remises. Basé sur les channel_partner_name et les ChannelPartnerRepricingConfig associés. Si credits.type est RESELLER_MARGIN, ce montant est égal à zéro.
credits.customer_amount Numérique Montant du crédit appliqué à l'utilisation, après les majorations de refacturation et les remises. Basé sur les customer_name et les CustomerRepricingConfig associés. Si credits.type est RESELLER_MARGIN, ce montant est égal à zéro.
adjustmentsInfo Struct, répété Contient des champs qui décrivent la structure et la valeur d'un ajustement des éléments de ligne de coût.
adjustmentsInfo.adjustment_id Chaîne Si ce champ 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. 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 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 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'une ChannelPartnerRepricingConfig existante.
customer_name Chaîne Nom de la ressource du client du revendeur qui a consommé cette ressource au format accounts/{account}/customers/{customer}
customer_cost Numérique Coût pour le 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 s'il est facturé avec un tarif public.
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 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 (Balises héritées = True) ou directe/non héritée (Balises héritées = 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é aux noms courts des clés de tag et des valeurs de tag afin de créer un nom complet unique et complet pour la clé ou la valeur de tag.
customer_correlation_id Chaîne ID de 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 Prix 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 avec trois niveaux de tarification (de 0 à 100 unités, de 101 à 1 000 unités et plus de 1 001 unités) affichera trois lignes tarifaires pour le SKU : 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 du SKU. En savoir plus sur les niveaux de tarification 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 (gibioctet, tébioctet, mois, année, gibioctet-heure, gibioctet-mois ou nombre, par exemple). 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 tarif du niveau est de 1 $pour 1 000 000 octets, cette colonne indiquera 1 000 000 octets.
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 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 null dans cette colonne ou 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 concernant l'exportation Google Workspace

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

  • Les données Google Workspace n'incluent pas les données sur l'utilisation par le 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 présentées sur une seule ligne. À l'exportation, les taxes sont réparties par client. Bien que le total des taxes doive correspondre à celui indiqué sur 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'ID Cloud Identity du client.

service et sku

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

usage_start_time et usage_end_time

Dans le fichier CSV de la facture Google Workspace, cela est indiqué sous forme de dates. Dans les exportations, ces éléments 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 associé à l'utilisation. Pour en savoir plus, consultez la section Utiliser des étiquettes.

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 étiquettes.

system_labels

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

  • Pour Google Workspace, voici des métadonnées supplémentaires concernant les coûts, qui incluent:

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

Voici les 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 à 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, le prélèvement s'étendra au cours du mois.
  • COMMITMENT_SEATS_CHANGE_ITEM: enregistré lorsque le niveau d'engagement change (augmentation ou diminution). Il commence souvent en milieu de mois et se termine à la fin du mois pour un abonnement avec engagement facturé mensuellement, ou jusqu'à la fin de la période de facturation/contrat pour un abonnement avec prépaiement.
  • COMMITMENT_CANCEL_ITEM: enregistré lorsqu'un abonnement est annulé. Inclut les frais associés à une résiliation anticipée. Représente soit des frais pour le reste de la période du contrat lorsque le contrat est résilié 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 GKE.
  • COMMITMENT_PREPAY_BILLING_PERIOD_ITEM: représente des informations d'utilisation créées au début du cycle de paiement pour l'intégralité du cycle pour un abonnement avec prépaiement avec engagement.

usage.amount

Pour l'utilisation du nombre de licences utilisateur Google Workspace, il s'agit des licences payantes. (par exemple, le nombre de licences utilisateur souscrites pour des engagements ou le nombre de licences achetées pour l'abonnement modulable).

usage.pricing_unit

credits.id

Pour Google Cloud, il s'agit soit d'un identifiant alphanumérique unique (12-b34-c56-d78), soit 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 associé à aucun crédit.

credits.full_name

Pour Google Cloud, il s'agit d'une description lisible d'un élément 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 avec une 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 : CPU), le champ credits.full_name sera vide.

credits.type

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

  • COMMITTED_USAGE_DISCOUNT : contrats d'engagement d'utilisation basés sur les ressources souscrits pour Compute Engine en échange de tarifs fortement réduits sur l'utilisation des VM.
  • COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE : contrats d'engagement d'utilisation basés sur les dépenses souscrits pour des services en échange de votre engagement de dépenser un montant minimal.
  • DISCOUNT: le type de crédit de la remise est utilisé pour les crédits gagnés une fois qu'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 offrent l'utilisation gratuite des ressources jusqu'aux limites spécifiées. Pour ces services, des crédits sont appliqués pour mettre en œuvre le niveau gratuit.
  • PROMOTION: le type d'avoir promotionnel inclut l'essai gratuit de Google Cloud, des crédits de campagne marketing ou d'autres subventions permettant d'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 de marge revendeur indique les remises du programme revendeur obtenues pour chaque article é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 est une remise automatique que vous recevez en exécutant des ressources Compute Engine spécifiques pendant une partie significative 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 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 bienveillance, dans le cadre d'un contrat.
  • SLA_VIOLATION: crédit accordé au client en raison d'un non-respect des objectifs de niveau de service (SLO).
  • BALANCE_TRANSFER: ajustement pour transférer des fonds d'un compte de paiement à un autre.
  • ACCOUNT_CLOSURE: ajustement visant à ramener 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 et le coût d'origine.
  • COMPLETE_NEGATION_WITH_REMONETIZATION: la correction annule complètement l'utilisation et le coût d'origine, et génère un ou plusieurs éléments de campagne corrigés avec une utilisation et un coût actualisés.
  • COMPLETE_NEGATION: la correction annule complètement l'utilisation et les coûts d'origine, et aucune autre utilisation n'est moné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 tarif 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 de tarifs personnalisés pour le contrat, il s'agit du tarif spécifique à votre compte de facturation. Sinon, il s'agit du prix catalogue du SKU ou du niveau de SKU.