Channel Services-Daten nach BigQuery exportieren

Auf dieser Seite erfahren Sie, wie Sie einen Channel Services-Export konfigurieren. Außerdem wird das verfügbare Schema für einen Export beschrieben.

Mit BigQuery können Sie Abrechnungsdaten für Channel Services in ein angegebenes BigQuery-Dataset exportieren. Mithilfe dieser Daten können Sie detailliert analysieren, wie Ihre Kunden oder Channelpartner die von Ihnen bereitgestellten Dienste nutzen.

Exporte aus Channel Services enthalten Reseller-spezifische Daten, die sonst nicht in Cloud Billing-Exporte aufgenommen werden. Dazu gehören Kosten, Guthaben und Nutzungsdaten mit Ihren konfigurierten Regeln für die Preisneuberechnung. Bei diesen Exporten werden auch alle Informationen zu den übergeordneten Abrechnungskonten Ihrer Kunden in einem einzigen Dataset zusammengefasst.

Daten aus einem Channel Services-Export sind jedoch mit Cloud Billing-Exporten kompatibel. Sie können beide Datasets mit Abfragen für die Analyse zusammenführen.

Informationen zu Cloud Billing-Exporten, die nicht von Resellern stammen, finden Sie unter Cloud Billing-Exporte in BigQuery einrichten.

Hinweise

Bevor Sie mit dem Export von Abrechnungsdaten für Channel Services beginnen, müssen Sie Folgendes tun:

  • Richten Sie ein Projekt zum Hosten Ihres BigQuery-Datasets ein. Achten Sie darauf, dass die Abrechnung für das Projekt aktiviert ist.
  • Aktivieren Sie die BigQuery Data Transfer Service API für das Projekt.
  • Erstellen Sie ein Dataset für Ihre exportierten Daten.

Wenn Sie bereits ein Projekt und ein BigQuery-Dataset für Cloud Billing-Datenexporte haben, können Sie dieses Projekt und Dataset für den Channel Services-Export wiederverwenden.

Ausführliche Informationen zum Einrichten eines Projekts und Datasets finden Sie unter Cloud Billing-Datenexport nach BigQuery einrichten.

Für Exporte erforderliche Berechtigungen

Sie benötigen die folgenden Rollen, um Channel Services-Exporte zu aktivieren und zu konfigurieren:

Projekt und Dataset auswählen

Wählen Sie in der Partner Sales Console ein BigQuery-Projekt und -Dataset aus, in dem die Channel Services-Daten gespeichert werden sollen. Aktivieren Sie die Abrechnung für das Projekt, falls sie noch nicht aktiviert ist.

Wenn Sie ein BigQuery-Dataset auswählen oder erstellen, können Sie einen der unterstützten BigQuery-Standorte für das Dataset auswählen. Wenn Sie den Datenexport für Channel Services zum ersten Mal pro Datenquelle (Google Cloud oder Google Workspace) aktivieren:

  • Wenn Sie Ihr BigQuery-Dataset für die Verwendung eines multiregionalen Standorts konfigurieren, sind BigQuery-Exportdaten für jede ausgewählte Datenquelle ab dem Beginn des Vormonats verfügbar. Wenn Sie beispielsweise den BigQuery-Export am 23. September aktivieren, enthält der Export Daten ab dem 1. August.

  • Wenn Sie Ihr BigQuery-Dataset für die Verwendung eines regionalen Standorts (außer multiregionaler Standort US oder EU) konfigurieren, sind Ihre BigQuery-Exportdaten für jede ausgewählte Datenquelle ab dem Datum verfügbar, an dem Sie den Export aktivieren, und danach. Das heißt, BigQuery-Exportdaten werden nicht rückwirkend für Dataset-Standorte mit mehreren Regionen hinzugefügt. Sie sehen also keine BigQuery-Exportdaten aus der Zeit vor der Aktivierung des Exports.

So exportieren Sie Abrechnungsdaten für mehrere Partner Sales Console-Konten:

  1. Prüfen Sie, ob die Abrechnungsadministratoren für jedes Partner Sales Console-Konto die Berechtigungen zum Aufrufen des BigQuery-Datasets haben, in das Sie Ihre Daten exportieren möchten.
  2. Wenn Sie den Export von Abrechnungsdaten in jedem Partner Sales Console-Konto einrichten, wählen Sie das einheitliche Dataset aus.

Unterstützte BigQuery-Standorte

BigQuery unterstützt zwei Arten von Regionen.

Multiregionen

In der folgenden Tabelle sind die Multiregionen aufgeführt, in denen der BigQuery-Datenexport für Channel Services unterstützt wird.

Beschreibung des multiregionalen Standorts Name des multiregionalen Standorts
Rechenzentren in Mitgliedsstaaten (externer Link) der Europäischen Union EU
Rechenzentren in den USA US

Regionen

In der folgenden Tabelle sind die Regionen in Amerika aufgeführt, in denen der BigQuery-Datenexport für Channel Services unterstützt wird.

Beschreibung der Region Name der Region
Iowa us-central1
Las Vegas us-west4
Los Angeles us-west2
Montreal northamerica-northeast1
Nord-Virginia us-east4
Oregon us-west1
Salt Lake City us-west3
São Paulo southamerica-east1
South Carolina us-east1

In der folgenden Tabelle sind die Regionen im asiatisch-pazifischen Raum aufgeführt, in denen der BigQuery-Datenexport für Channel Services unterstützt wird.

Beschreibung der Region Name der Region
Hongkong asia-east2
Jakarta asia-southeast2
Mumbai asia-south1
Osaka asia-northeast2
Seoul asia-northeast3
Singapur asia-southeast1
Sydney australia-southeast1
Taiwan asia-east1
Tokio asia-northeast1

In der folgenden Tabelle sind die Regionen in Europa aufgeführt, in denen der BigQuery-Datenexport für Channel Services unterstützt wird.

Beschreibung der Region Name der Region
Belgien europe-west1
Finnland europe-north1
Frankfurt europe-west3
London europe-west2
Netherlands europe-west4
Warschau europe-central2
Zürich europe-west6

Export aktivieren

Bevor Sie den Datenexport aktivieren, notieren Sie sich die vollständig qualifizierte Dataset-ID im Format PROJECT_ID:DATASET_NAME.

So aktivieren Sie den Export von Channel Services:

  1. Rufen Sie in der Partner Sales Console die Seite Abrechnung auf.
  2. Wählen Sie Abrechnungsexport aus.
  3. Geben Sie die voll qualifizierte Dataset‑ID in das Feld Datenpool für die Preisneuberechnung ein.
  4. Wählen Sie die Datenquellen aus, für die Daten exportiert werden sollen.
  5. Klicken Sie auf Aktualisieren. Wenn Sie aufgefordert werden, Dataset-Berechtigungen zu aktualisieren, klicken Sie auf Aktualisieren.

Benutzeroberfläche zum Aktivieren von Exporten für Preisneuberechnungen

Nach der Einrichtung liefert der Abrechnungsexport täglich inkrementelle Nutzungsdaten. Die Exporttabelle wird erst angezeigt, wenn der Abrechnungsexport zum ersten Mal für Ihr Konto ausgeführt wird. Das Dataset enthält Daten ab dem Zeitpunkt, an dem es zum ersten Mal für die Datenaufbewahrung konfiguriert wurde.

Wenn Sie den Export von Kostendaten für die Preisneuberechnung in das Dataset beenden möchten, klicken Sie auf der Seite Preisneuberechnung für Kunden auf Export von Abrechnungsdaten deaktivieren. Wenn Sie den Export wieder aktivieren möchten, folgen Sie der Anleitung oben, um eine Dataset-ID anzugeben.

Für den Zeitraum, in dem der Export deaktiviert war, sind möglicherweise keine Kostendaten für die Preisneuberechnung verfügbar. Wenn Sie in diesem Zeitraum exportierte Daten gelöscht haben, können wir die gelöschten Einträge nicht wieder auffüllen.

Erforderliche Dienstkontoberechtigungen

Für den Datenexport für Channel Services wird ein Dienstkonto verwendet, das Google gehört und von Google verwaltet wird und das die Berechtigung zum Schreiben von Abrechnungsdatensätzen in eine Tabelle hat. Das Dienstkonto ist:

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

Für dieses Dienstkonto ist die vordefinierte Rolle roles/bigquery.dataEditor erforderlich, um Exporte zu ermöglichen. Sie können die Berechtigungen konfigurieren, indem Sie die Schritte zum Aktivieren des Exports ausführen.

Daten effizient abfragen

Die BigQuery-Tabelle ist standardmäßig nach export_time partitioniert und nach payer_billing_account_id geclustert. Das bedeutet, dass die Tabelle in kleinere Partitionen unterteilt wird, die jeweils in kleinere Cluster unterteilt sind. Wenn Sie die Partitions- und Clusterschlüssel in einer Abfrage verwenden, kann BigQuery die relevanten Daten schnell finden. Dadurch können die Kosten der Abfrage erheblich gesenkt werden.

Diese Abfrage ist beispielsweise effizienter als eine Abfrage ohne Partitionierungs- und Clustering-Schlüssel:

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;

Weitere Informationen zu Partitionierung, Clustering und Best Practices finden Sie unter den folgenden Links:

  1. Partitionierte Tabellen abfragen
  2. Geclusterte Tabellen abfragen
  3. Abfrageleistung optimieren
  4. Best Practices für die Kostenkontrolle in BigQuery

Rechnungskonto-ID des Zahlungspflichtigen ermitteln

Um die Rechnungskonto-ID des Zahlungspflichtigen zu finden, öffnen Sie die Seite „Rechnungskonten“ der Partner Sales Console und klicken Sie auf den Tab Partnerabrechnung.

Sie sehen alle Rechnungskonten und die IDs der Rechnungskonten des Zahlungspflichtigen.

ID des Rechnungskontos des Zahlungspflichtigen

Zugriffssteuerung für andere Nutzer für das Export-Dataset einrichten

Es gibt mehrere Möglichkeiten, Zugriffssteuerungen für die Daten im BigQuery-Export einzurichten. Weitere Informationen finden Sie unter BigQuery-Zugriffssteuerung.

Damit Nutzer nur auf Daten zugreifen können, die sie ansehen dürfen, empfehlen wir, autorisierte Ansichten einzurichten, um Daten aus Ihrem exportierten Dataset freizugeben.

Wenn Sie Berechtigungen für Nutzer einrichten, muss das Dienstkonto cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com immer vollen Bearbeiterzugriff auf das Export-Dataset haben.

Tabellenschema

Das folgende Schema beschreibt die Daten in der BigQuery-Tabelle.

In Ihrem BigQuery-Dataset wird der detaillierte Rebilling-Export in eine Datentabelle mit dem Namen reseller_billing_detailed_export_v1 geladen.

Feld Typ Beschreibung
billing_account_id String Die Konto-ID, der die Nutzung zugeordnet ist. Das kann die Konto-ID des Kunden oder Ihre eigene sein. Je nach Produktfamilie kann dies ein Rechnungskonto oder eine Cloud Identity sein.
payer_billing_account_id String Die ID Ihres übergeordneten Rechnungskontos.
invoice.month String Das Jahr und der Monat (JJJJMM) der Rechnung, die die Kostenpositionen enthält. Beispiel: „202101“ entspricht Januar 2021.
cost_type String Die Art der Kosten dieser Position: regelmäßige Kosten, Steuern, Korrekturen oder Rundungsfehler.
service.id String Die ID des Dienstes, mit dem die Nutzung verknüpft ist.
service.description String Der Google-Dienst, der die Abrechnungsdaten gemeldet hat.
sku.id String Die Artikelnummer-ID der vom Dienst verwendeten Ressource.
sku.description String Eine Beschreibung des vom Dienst verwendeten Ressourcentyps. Cloud Storage ist beispielsweise vom Typ Standard Storage US.
usage_start_time Zeitstempel Die Startzeit des stündlichen Nutzungszeitfensters, in dem die berechneten Kosten angefallen sind. Nutzung und Kosten werden für alle Dienste mit stündlicher Genauigkeit angezeigt. Eine lange Dauer der Dienstnutzung verteilt sich auf mehrere Stundenzeitfenster. Bei Aboprodukten ist das der Beginn des Abrechnungsmonats.
usage_end_time Zeitstempel Die Endzeit des stündlichen Nutzungszeitfensters, in dem die berechneten Kosten angefallen sind. Nutzung und Kosten werden für alle Dienste mit stündlicher Genauigkeit angezeigt. Eine lange Dauer der Dienstnutzung verteilt sich auf mehrere Stundenzeitfenster. Bei Aboprodukten ist das das Ende des Abrechnungsmonats.
project Struct Informationen zum Google Cloud -Projekt, das die Cloud Billing-Daten generiert hat.
project.number String Eine intern generierte, anonymisierte und eindeutige Kennung für das Google Cloud -Projekt, das die Cloud Billing-Daten generiert hat.
project.id String Die ID des Google Cloud -Projekts, das die Cloud Billing-Daten generiert hat.
project.name String Der Name des Google Cloud -Projekts, das die Cloud Billing-Daten generiert hat.
project.labels Struct, wiederholt
project.labels.key String Wenn Labels vorhanden sind, ist dies der Schlüssel im Schlüssel/Wert-Paar.
project.labels.value String Wenn Labels vorhanden sind, ist dies der Wert im Schlüssel/Wert-Paar.
project.ancestry_numbers String Die Ancestors in der Ressourcenhierarchie für das Projekt, das durch die project.id identifiziert wird.
labels Struct, wiederholt
labels.key String Wenn Labels vorhanden sind, ist dies der Schlüssel im Schlüssel/Wert-Paar.
labels.value String Wenn Labels vorhanden sind, ist dies der Wert im Schlüssel/Wert-Paar.
system_labels Struct, wiederholt
system_labels.key String Wenn Systemlabels vorhanden sind, ist dies der Schlüssel im Schlüssel/Wert-Paar.
system_labels.value String Wenn Systemlabels vorhanden sind, ist dies der Wert im Schlüssel/Wert-Paar.
location.location String Standort der Nutzung auf der Ebene eines Landes, einer Region oder einer Zone. Zeigt global für Ressourcen ohne bestimmten Standort an. Weitere Informationen finden Sie unter Regionen und Zonen.
location.country String Wenn location.location ein Land, eine Region oder eine Zone ist, enthält dieses Feld das Land der Nutzung. Beispiel: US. Weitere Informationen finden Sie unter Regionen und Zonen.
location.region String Wenn location.location ein Land oder eine Region ist, enthält dieses Feld die Nutzungsregion. Beispiel: us-central1. Weitere Informationen finden Sie unter Regionen und Zonen.
location.zone String Wenn location.location eine Zone ist, enthält dieses Feld die Zone der Nutzung. Beispiel: us-central1-a. Weitere Informationen finden Sie unter Regionen und Zonen.
resource Struct Beschreibt die Struktur und den Wert von Informationen, die für Dienstressourcen (z. B. virtuelle Maschinen oder SSDs) relevant sind, die eine Dienstnutzung generieren.
resource.name String Eine dienstspezifische Kennung für die Ressource, die eine relevante Nutzung generiert hat. Kann von Nutzern generiert werden.
resource.global_name String Eine global eindeutige Dienstkennung für die Ressource, die eine relevante Nutzung generiert hat.
cost Numerisch Die Kosten für die Nutzung ohne angewendete Gutschriften. Wenn Sie die Gesamtkosten einschließlich Gutschriften berechnen möchten, müssen Sie credits.amount zu cost hinzufügen.
currency String Die Abrechnungswährung der Kosten. Weitere Informationen zur Landeswährung für Abrechnung und Zahlungen
currency_conversion_rate Float Der Wechselkurs von US-Dollar in die Landeswährung. Das heißt, cost ÷ currency_conversion_rate entspricht den Kosten in US-Dollar.
usage.amount Numerisch Die Menge der verwendeten usage.unit.
usage.unit String Die Basiseinheit für die Messung der Ressourcennutzung. Die Basiseinheit für Standard Storage ist z. B. Byte-Sekunden.
usage.amount_in_pricing_unit Numerisch Die Menge der verwendeten usage.pricing_unit.
usage.pricing_unit String Die Einheiten zum Messen der Ressourcennutzung.
credits Struct, wiederholt Enthält Felder, die die Struktur und den Wert von Gutschriften beschreiben.
credits.id String Falls vorhanden, weist das Attribut auf eine Gutschrift hin zu der Produkt-SKU hin.
credits.full_name String Der Name der Gutschrift, die mit der Artikelnummer des Produkts verknüpft ist.
credits.type String Dieses Feld beschreibt den Zweck oder Ursprung des credits.id.
credits.name String Eine Beschreibung der Gutschrift, die auf die Nutzung angewendet wurde.
credits.amount Numerisch Der Betrag der Gutschrift, die auf die Nutzung angerechnet wird.
credits.channel_partner_amount Numerisch Der Betrag der Gutschrift, die auf die Nutzung angerechnet wird, nach einer Preisneuberechnung durch Aufschläge und Rabatte. Basierend auf dem channel_partner_name und dem zugehörigen ChannelPartnerRepricingConfig. Wenn credits.type RESELLER_MARGIN ist, ist dieser Betrag null.
credits.customer_amount Numerisch Der Betrag der Gutschrift, die auf die Nutzung angerechnet wird, nach einer Preisneuberechnung durch Aufschläge und Rabatte. Basierend auf dem customer_name und dem zugehörigen CustomerRepricingConfig. Wenn credits.type RESELLER_MARGIN ist, ist dieser Betrag null.
adjustmentsInfo Struct, wiederholt Enthält Felder, die die Struktur und den Wert einer Anpassung an Kostenpositionen beschreiben.
adjustmentsInfo.adjustment_id String Falls vorhanden, ist eine Korrektur mit einer Kostenposition verknüpft. adjustmentsInfo.adjustments_id ist die eindeutige ID für alle Anpassungen, die durch ein Problem verursacht werden.
adjustmentsInfo.adjustment_description String Eine Beschreibung der Korrektur und ihre Ursache.
adjustmentsInfo.adjustment_type String Die Art der Anpassung.
adjustmentsInfo.adjustment_mode String Hiermit wird beschrieben, wie die Korrektur ausgeführt wird.
export_time Zeitstempel Die mit neu angehängten Abrechnungsdaten verbundene Verarbeitungszeit. Dieser Zeitraum verlängert sich mit jedem neuen Export. In der Spalte export_time sehen Sie, wann die exportierten Abrechnungsdaten zuletzt aktualisiert wurden.
entitlement_name String Der Ressourcenname der Berechtigung der Cloud Channel API. Verwendet das Format: accounts/{account}/customers/{customer}/entitlements/{entitlement}
channel_partner_name String Nur für Distributoren: Der Ressourcenname des Channelpartners, der an den Endkunden verkauft. Verwendet das Format: accounts/{account}/channelPartnerLinks/{channelPartner}.
channel_partner_cost Numerisch Nur für Distributoren: Die Kosten für den Channelpartner, der durch channel_partner_name angegeben ist, nach Anwendung einer vorhandenen ChannelPartnerRepricingConfig.
customer_name String Der Ressourcenname des Kunden des Resellers, der diese Nutzung bewirkt hat, im Format „accounts/{account}/customers/{customer}“
customer_cost Numerisch Die Kosten für den Reseller-Kunden, der in der Spalte customer_name angegeben ist, nach Anwendung von CustomerRepricingConfig, sofern vorhanden.
cost_at_list Numerisch Die Kosten, wenn sie nach den öffentlichen Preisen abgerechnet würden.
customer_repricing_config_name String Der Ressourcenname der Cloud Channel API CustomerRepricingConfig. Verwendet das Format: accounts/{account}/customers/{customer}/customerRepricingConfigs/{id}.
channel_partner_repricing_config_name String (Nur für Vertriebspartner) Der Ressourcenname der Cloud Channel API ChannelPartnerRepricingConfig. Verwendet das Format: accounts/{account}/channelPartnerLinks/{channelPartner}/channelPartnerRepricingConfigs/{id}.
tags Struct Felder, die das Tag beschreiben, z. B. Schlüssel, Wert und Namespace.
tags.key String Der Kurz- oder Anzeigename des Schlüssels, der mit diesem Tag verknüpft ist.
tags.value String Die Ressourcen, die an einen Tag-Schlüssel angehängt sind. Für einen bestimmten Schlüssel kann jeweils immer genau ein Wert an eine Ressource angehängt werden.
tags.inherited Boolesch Gibt an, ob eine Tag-Bindung übernommen wurde (Tags „übernommen = wahr“) oder direkt/nicht übernommen (Tags „übernommen = falsch“).
tags.namespace String Stellt die Ressourcenhierarchie dar, die Tag-Schlüssel und -Werte definiert. Der Namespace kann mit den Kurznamen für Tag-Schlüssel und Tag-Werte kombiniert werden, um einen global eindeutigen, voll qualifizierten Namen für den Tag-Schlüssel oder den Tag-Wert zu erstellen.
customer_correlation_id String Die externe CRM-ID für den Kunden. Wird nur ausgefüllt, wenn für diesen Kunden eine CRM-ID vorhanden ist.
price Struct Felder, die Struktur und Wert im Bezug auf Nutzungskosten beschreiben.
price.effective_price Numerisch SKU-Preis gemäß dem anwendbaren Verbrauchsmodell gemäß den benutzerdefinierten Preisen im Vertrag, der mit Ihrem Cloud-Rechnungskonto verknüpft ist.
price.tier_start_amount Numerisch Die Untergrenze für Einheiten für die Preisstufe einer Artikelnummer. Beispiel: Eine SKU mit drei Preisstufen (1 bis 100 Einheiten, 101 bis 1.000 Einheiten und mehr als 1.001 Einheiten) zeigt drei Preiszeilen für die SKU (0, 101 und 1.001) im price.tier_start_amount-Feld an, das die Starteinheitsmenge für die SKU-Preisstufen darstellt. Weitere Informationen zu Google Cloud Preisstufen
price.unit String Die Nutzungseinheit, in der die Preise angegeben und die Ressourcennutzung gemessen wird (z. B. Gibibyte, Tebibyte, Monat, Jahr, Gibibyte-Stunde, Gibibyte pro Monat oder Anzahl). Der Wert im Feld price.unit entspricht dem Wert im Feld usage.pricing_unit.
price.pricing_unit_quantity Numerisch Die Einheitsmenge der Preisstufe für die SKU. Wenn z. B. der Stufenpreis 1 $pro 1.000.000 Byte ist, wird in dieser Spalte 1000000 angezeigt.
price.list_price Numerisch Der SKU-Preis gemäß dem Standardnutzungsmodell.
price.effective_price_default Numerisch SKU-Preis gemäß dem Standardnutzungsmodell gemäß den benutzerdefinierten Preisen im Vertrag, der mit Ihrem Cloud-Rechnungskonto verknüpft ist.
price.list_price_consumption_model Numerisch SKU-Listenpreis gemäß dem anwendbaren Nutzungsmodell.
transaction_type String Der Transaktionstyp des Verkäufers. Folgende Transaktionstypen sind möglich:
  • GOOGLE = 1: Von Google Cloudverkaufte Dienste.
  • THIRD_PARTY_RESELLER = 2: Drittanbieterdienste, die von Google Cloudweiterverkauft werden.
  • THIRD_PARTY_AGENCY = 3: Drittanbieterdienste, die von einem Partner verkauft werden, wobei Google Cloud als Agent fungiert.
seller_name String Der rechtliche Name des Verkäufers.
subscription Struct Felder, die Ihre ausgaben- oder ressourcenbasierten Zusicherungen beschreiben. Mit diesen Feldern können Sie Ihre Gebühren für bestimmte Zusicherungen analysieren.
subscription.instance_id String Die Abo-ID, die mit einer Nutzungszusicherung verknüpft ist.
cost_at_effective_price_default Numerisch Kosten gemäß dem Standardverbrauchsmodell gemäß den benutzerdefinierten Preisen im Vertrag, der mit Ihrem Cloud-Rechnungskonto verknüpft ist.
cost_at_list_consumption_model Numerisch Kosten gemäß dem anwendbaren Verbrauchsmodell.
consumption_model Struct Felder, die das anwendbare Nutzungsmodell beschreiben.
consumption_model.id String Die ID des Nutzungsmodells.
consumption_model.description String Die Beschreibung des Nutzungsmodells.

Zusätzliche Hinweise zum Schema

Es gibt einige zusätzliche Hinweise zum Schema.

Spalten, die nicht für Google Workspace gelten

Wenn eine Spalte oder ein Feld nicht für eine Produktfamilie gilt, enthalten die exportierten Daten für diese Produktfamilie null in diesem Feld. Die folgenden Felder sind für Google Workspace-Exporte nicht relevant:

  • project
  • labels
  • resource
  • credits
  • adjustmentsInfo
  • customer_repricing_config_name
  • channel_partner_repricing_config_name
  • tags
  • price.effective_price
  • price.tier_start_amount
  • price.list_price
  • price.effective_price_default
  • price.list_price_consumption_model
  • transaction_type
  • seller_name
  • consumption_model

Spalten, die nicht für Google Workspace-SKUs mit nutzungsbasierter Abrechnung gelten

Wenn eine Spalte oder ein Feld nicht für eine Produktfamilie gilt, enthalten die exportierten Daten für diese Produktfamilie null in diesem Feld. Die folgenden Felder sind für Google Workspace-Exporte nicht relevant:

  • service.id
  • sku.id
  • project
  • labels
  • resource
  • customer_repricing_config_name
  • channel_partner_repricing_config_name
  • tags
  • price.effective_price
  • price.tier_start_amount
  • transaction_type
  • seller_name
  • subscription

Spalten, die nicht auf Offlinebestellungen angewendet werden können (Vorschau)

Wenn eine Spalte oder ein Feld nicht für eine Produktfamilie gilt, enthalten die exportierten Daten für diese Produktfamilie null in dieser Spalte oder diesem Feld. Die folgenden Spalten oder Felder gelten nicht für Abrechnungsexporte für Offlinebestellungen:

  • project
  • labels
  • system_labels
  • location
  • resource
  • credits
  • entitlement_name
  • channel_partner_name
  • channel_partner_cost
  • customer_name
  • customer_cost
  • cost_at_list
  • customer_repricing_config_name
  • channel_partner_repricing_config_name
  • tags
  • price.effective_price
  • price.tier_start_amount
  • price.list_price
  • price.effective_price_default
  • price.list_price_consumption_model
  • transaction_type
  • seller_name
  • consumption_model

Weitere Hinweise zum Google Workspace-Export

Bei Google Workspace-Exporten gibt es einige Besonderheiten:

  • Google Workspace-Daten enthalten nicht die Nutzung durch den Reseller selbst.
  • Wenn cost_type gleich tax und adjustment ist, ist usage.amount_in_pricing_units immer 1.
  • Auf Google Workspace-Rechnungen werden Steuern als eine Position aufgeführt. Im Export werden Steuern nach Kunde aufgeschlüsselt. Die Gesamtsteuer sollte mit der Rechnung übereinstimmen. Bei den einzelnen Steuern kann es jedoch zu geringfügigen Rundungsungenauigkeiten kommen.

billing_account_id

  • Für Google Cloudist dies das Cloud-Rechnungskonto, dem die Nutzung zugeordnet ist.
  • Bei Google Workspace ist das die Cloud Identity des Kunden.
  • Bei Offlinebestellungen ist das der Name des Kunden.

service und sku

Für Google Workspace stellen diese Spalten das „Produkt“ und die „Artikelnummer“ dar, die mit der Nutzung verknüpft sind. Weitere Informationen zu Produkt- und Artikelnummern .

Bei verbrauchsabhängigen Google Workspace-Artikelnummern (Google Voice und Drive) enthalten die Spalten sku.id und service.id null.

usage_start_time und usage_end_time

In der CSV-Datei der Google Workspace-Rechnung werden diese als Datumsangaben dargestellt. In den Exporten werden diese als Zeitstempel dargestellt:

  • Für usage_start_time ist das die Startzeit (einschließlich) des Abos um 0:00 Uhr PST am Startdatum.
  • Für usage_end_time ist dies die Endzeit (exklusiv) des Abos, um 0:00 Uhr PST am Tag nach dem Enddatum.

project.labels

Für Google Cloudsind dies die Schlüssel/Wert-Paare imGoogle Cloud Projekt, in dem die Nutzung stattgefunden hat. Weitere Informationen finden Sie unter Labels verwenden.

labels

Für Google Cloudsind dies die Schlüssel/Wert-Paare für die Google Cloud-Ressource, in der die Nutzung stattgefunden hat. Weitere Informationen finden Sie unter Labels verwenden.

system_labels

  • Für Google Cloudsind dies die Schlüssel/Wert-Paare für dieGoogle Cloud Ressource, in der die Nutzung stattgefunden hat. Weitere Informationen finden Sie unter Verfügbare Systemlabels.

  • Für Google Workspace sind das zusätzliche Metadaten zu den Kosten, darunter:

    • workspace.googleapis.com/domain_name: Der Domainname des Kunden.
    • workspace.googleapis.com/order_id: Die Bestell-ID.
    • workspace.googleapis.com/purchase_order_id: Die ID des Auftrags.
    • workspace.googleapis.com/subscription_id: Die Abo-ID.
    • workspace.googleapis.com/usage_type: Der Nutzungstyp. Nicht zutreffend, wenn cost_type nicht regular ist.

Die Google Workspace-Nutzungstypen umfassen:

  • COMMITMENT_TERM_START_ITEM: Beginn eines Abos. In der Regel im Zusammenhang mit einem Teilmonat für ein monatlich abgerechnetes Abo mit Zusicherung und für den Abrechnungs- oder Vertragszeitraum für ein Prepaid-Abo.
  • COMMITMENT_TERM_END_ITEM: Ende eines Abos. Hängt in der Regel mit den Gebühren des letzten Monats eines monatlich abgerechneten Zusicherungsabos zusammen.
  • COMMITMENT_TERM_RENEWAL_ITEM: Beginn eines nachfolgenden Abozeitraums.
  • COMMITMENT_MONTHLY_ITEM: Nutzung, die für Zusicherungen erfasst wurde, die zu Beginn des Monats vorhanden waren. In den meisten Fällen erstreckt sich die Gebühr über den gesamten Monat.
  • COMMITMENT_SEATS_CHANGE_ITEM: Wird aufgezeichnet, wenn sich die Zusicherungsebene ändert (entweder erhöht oder verringert). Beginnt oft in der Mitte des Monats und dauert bis zum Monatsende bei einem Abo mit monatlicher Abrechnung oder bis zum Ende des Abrechnungs- oder Vertragszeitraums bei einem Prepaid-Abo.
  • COMMITMENT_CANCEL_ITEM: Wird aufgezeichnet, wenn ein Abo gekündigt wird. Enthält Gebühren für eine vorzeitige Kündigung. Entspricht entweder einer Gebühr für die verbleibende Vertragslaufzeit, wenn der Vertrag vorzeitig gekündigt wird, oder einer Gutschrift für den verbleibenden Abrechnungszeitraum, wenn ein Vertrag vorzeitig geändert oder gekündigt wird.
  • FLEXIBLE_SEATS_ITEM: Erfasst die Nutzung durch eine bestimmte Anzahl von Nutzern für einen zusammenhängenden Block von einer bestimmten Anzahl von Tagen. Nur für Nutzer ohne Mindestlaufzeit.
  • COUPON_DISCOUNT_ITEM: Der Rabattbetrag, der einem Gutschein zugeordnet ist.
  • MIGRATED_CREDIT_ITEM: Guthaben aus der Postini-Migration.
  • COMMITMENT_PREPAY_BILLING_PERIOD_ITEM: Steht für Nutzungsinformationen, die zu Beginn des Zahlungszeitraums für den gesamten Zeitraum für ein Abo mit Vorauszahlung für eine Mindestabnahme erstellt werden.

usage.amount

Bei der lizenzbasierten Nutzung von Google Workspace gibt dies die Anzahl der bezahlten Lizenzen an. Zum Beispiel vergebene Lizenzen bei Verträgen oder die Anzahl der Lizenzen, die beim flexiblen Tarif bezahlt werden.

Bei verbrauchsbasierten Google Workspace-SKUs (Google Voice und Drive) ist dies die Anzahl der verwendeten Minuten.

usage.pricing_unit

  • Weitere Informationen zur Cloud Billing Catalog API für Google Cloud{: track-type="tasks" class="external" track-name="externalLink" track-metadata-position="body"}
  • Für Google Workspace ist das count.

credits.id

Für Google Cloudist dies entweder eine eindeutige alphanumerische Kennung (12-b34-c56-d78) oder eine Beschreibung des Guthabentyps (Rabatt für zugesicherte Nutzung: CPU). Wenn das Feld credits.id leer ist, ist die Artikelnummer des Produkts nicht mit einem Guthaben verknüpft.

credits.full_name

Für Google Cloudist dies eine für Menschen lesbare Beschreibung eines alphanumerischen credits.id. Beispiele sind Guthaben für kostenlose Testversion oder ausgabenbasierter Rabatt für zugesicherte Nutzung. credits.full_name-Werte werden nur für Artikelnummern mit einem alphanumerischen credits.id ausgefüllt. Wenn der Wert von credits.id eine Beschreibung des Gutschriftentyps ist (z. B. Rabatt für zugesicherte Nutzung: CPU), dann ist das Feld credits.full_name leer.

credits.type

Für Google Cloudgibt es folgende Gutschriftentypen:

  • COMMITTED_USAGE_DISCOUNT: Ressourcenbasierte Verträge für zugesicherte Nutzung, die für Compute Engine erworben werden und im Gegenzug erhebliche Rabatte auf die VM-Nutzung erhalten.
  • COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE : Ausgabenbasierte Verträge mit Nutzungszusage, die für Dienstleistungen im Austausch gegen Ihre Zusage, einen Mindestbetrag auszugeben, erworben werden.
  • DISCOUNT: Der Rabatttyp wird für Gutschriften verwendet, die Sie nach Erreichen eines vertraglich festgelegten Ausgabenbetrags erhalten haben. In den Cloud Billing-Berichten, die in der Partner Sales Console verfügbar sind, wird der Rabatttyp als Ausgabenbasierte Rabatte (vertraglich) aufgeführt.
  • FREE_TIER: Einige Dienste bieten eine kostenlose Ressourcennutzung bis zu einem bestimmten Limit. Bei diesen Diensten wird mit Gutschriften die Nutzung der kostenlosen Stufe implementiert.
  • PROMOTION: Der Gutschriftentyp „Promotion“ umfasst einen Google Cloud kostenlosen Testzeitraum und Gutschriften für Marketingkampagnen oder andere Zuwendungen zur Nutzung von Google Cloud. Vorhandenes Startguthaben wird als Zahlungsmittel betrachtet und automatisch angewendet, um die Gesamtkosten zu reduzieren.
  • RESELLER_MARGIN: Wenn Sie Reseller sind, zeigt der Gutschriftentyp Reseller-Marge die Rabatte für das Reseller-Programm für jede infrage kommende Position an.
  • SUBSCRIPTION_BENEFIT: Gutschriften, die Sie durch den Kauf eines langfristigen Abos für Dienste erhalten.
  • SUSTAINED_USAGE_DISCOUNT: Der Gutschriftentyp „Rabatte für kontinuierliche Nutzung“ ist ein automatischer Rabatt, den Sie erhalten, wenn Sie bestimmte Compute Engine-Ressourcen für einen erheblichen Teil des Abrechnungsmonats nutzen.

adjustmentsInfo

Für Google Cloudwerden diese Werte nur ausgefüllt, wenn die Kostenposition für eine Cloud Billing-Änderung generiert wurde. Der Typ adjustmentsInfo enthält Details zur Korrektur, unabhängig davon, ob sie zur Behebung eines Fehlers oder aus anderen Gründen vorgenommen wurde.

adjustmentsInfo.adjustment_type

Für Google Cloudumfasst dies:

  • USAGE_CORRECTION: Eine Korrektur aufgrund einer falsch gemeldeten Nutzung.
  • PRICE_CORRECTION: Eine Korrektur aufgrund falscher Preismodellregeln.
  • METADATA_CORRECTION: Eine Korrektur, um Metadaten zu korrigieren, ohne die Kosten zu ändern.
  • GOODWILL: Ein Guthaben, das dem Kunden gutgeschrieben wird.
  • SALES_BASED_GOODWILL: Ein Guthaben, das dem Kunden aus Kulanz im Rahmen eines Vertrags gewährt wird.
  • SLA_VIOLATION: Ein Guthaben, das dem Kunden aufgrund eines Verstoßes gegen das Service Level Objective (SLO) ausgestellt wird.
  • BALANCE_TRANSFER: Eine Korrektur, um Geld von einem Zahlungskonto auf ein anderes zu übertragen.
  • ACCOUNT_CLOSURE: Eine Korrektur, um ein geschlossenes Konto auf null zu bringen.
  • GENERAL_ADJUSTMENT: Eine allgemeine Änderung des Cloud-Rechnungskonto.

adjustmentsInfo.adjustment_mode

Für Google Cloudumfasst dies:

  • PARTIAL_CORRECTION: Bei der Korrektur werden die ursprüngliche Nutzung und die Kosten teilweise negiert.
  • COMPLETE_NEGATION_WITH_REMONETIZATION: Bei der Korrektur werden die ursprüngliche Nutzung und die Kosten vollständig geschätzt und die korrigierten Positionen mit aktualisierter Nutzung und Kosten ausgegeben.
  • COMPLETE_NEGATION: Bei der Korrektur werden die ursprüngliche Nutzung und die Kosten vollständig negiert. Es wird keine weitere Nutzung wieder monetarisiert.
  • MANUAL_ADJUSTMENT: Die Anpassung wird manuell Kosten und Nutzung zugeordnet.

price.effective_price

Für Google Cloudist dies der Preis für die Nutzung derGoogle Cloud oder Google Maps Platform-SKUs und Preisstufen. Wenn Ihr Cloud-Rechnungskonto benutzerdefinierte Vertragspreise enthält, ist dieser Preis spezifisch für Ihr Cloud-Rechnungskonto. Andernfalls ist dies der Listenpreis der SKU oder SKU-Stufe.