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 bestimmtes BigQuery-Dataset exportieren. Anhand dieser Daten können Sie eine detaillierte Analyse dazu durchführen, wie Ihre Kunden oder Channelpartner die von Ihnen angebotenen Dienste nutzen.
Exporte aus Channel Services enthalten Reseller-spezifische Daten, die nicht in Cloud Billing-Exporten enthalten sind. Hierzu gehören Kosten, Guthaben und Nutzungsdaten mit Ihren konfigurierten Preisneuberechnungsregeln. Außerdem werden in diesen Exporten alle Informationen zu den übergeordneten Abrechnungskonten Ihrer Kunden in einem einzigen Datensatz zusammengefasst.
Daten aus einem Channel Services-Export sind jedoch mit Cloud Billing-Exporten kompatibel. Sie können beide Datensätze mithilfe von Abfragen für die Analyse zusammenführen.
Informationen zu Cloud Billing-Exporten für andere Nutzer als Reseller 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 dieses Dataset für den Export von Channel Services 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:
Wenn Sie das Ziel-Dataset in BigQuery erstellt haben, benötigen Sie
BigQuery User
für das Projekt, das das Dataset enthält. Wenn der Datensatz von einer anderen Person erstellt wurde, benötigen Sie die RolleBigQuery Data Owner
.Wenn Sie Google Cloud-Exporte aktivieren möchten, benötigen Sie in der Partner Sales Console die Rolle „Google Cloud-Reseller-Administrator“.
Weitere Informationen zum Zuweisen von Google Cloud-Rollen in der Partner Sales Console
Wenn Sie Google Workspace-Exporte aktivieren möchten, müssen Sie Reseller-Administrator sein oder die Berechtigungen für die Google Workspace-Abrechnung haben.
Weitere Informationen zum Zuweisen von Google Workspace-Rollen in der Partner Sales Console
Optional:
Project Viewer
für das Projekt, das das BigQuery-Ziel-Dataset enthält, um automatisch zu prüfen, ob die Abrechnung für das Projekt aktiviert ist.
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 dies noch nicht getan haben.
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, geschieht Folgendes:
Wenn Sie [BigQuery
Dataset](/bigquery/docs/datasets-intro) für die Verwendung eines multiregionalen Standorts konfiguriert haben, 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 [BigQuery
Dataset](/bigquery/docs/datasets-intro) so konfigurieren, dass ein regionaler Standort verwendet wird (außer multiregionale Standorte in den USA oder der EU), sind Ihre BigQuery-Exportdaten 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 nur einer Region 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:
- Achten Sie darauf, dass die Abrechnungsadministratoren für jedes Partner Sales Console-Konto Berechtigungen zum Ansehen des BigQuery-Datasets haben, in das Sie Ihre Daten exportieren möchten.
- Wählen Sie beim Einrichten des Exports von Abrechnungsdaten in jedem Partner Sales Console-Konto den einheitlichen Datensatz 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 von 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 von 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 von 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 von 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
Notieren Sie sich die vollständige Dataset-ID im Format PROJECT_ID:DATASET_NAME, bevor Sie den Datenexport aktivieren.
So aktivieren Sie den Export für Channel Services:
- Rufen Sie in der Partner Sales Console die Seite Abrechnung auf.
- Wählen Sie Abrechnungsexport aus.
- Geben Sie die voll qualifizierte Dataset-ID in das Feld Datenpool für die Preisneuberechnung ein.
- Wählen Sie die Datenquellen aus, für die Daten exportiert werden sollen.
- Klicken Sie auf Aktualisieren. * Wenn Sie aufgefordert werden, Dataset-Berechtigungen zu aktualisieren, klicken Sie auf Aktualisieren.
Nach der Einrichtung liefert der Abrechnungsexport täglich inkrementelle Nutzungsdaten. Die Exporttabelle wird erst angezeigt, wenn der Abrechnungsexport für Ihr Konto zum ersten Mal ausgeführt wird. Der Datensatz enthält Daten aus der Zeit, als er zum ersten Mal so konfiguriert wurde, dass Daten aufbewahrt werden.
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, geben Sie wie oben beschrieben eine Dataset-ID an.
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 Berechtigungen für Dienstkonten
Für den Datenexport von Channel Services wird ein Dienstkonto verwendet, das Google gehört und verwaltet und das die Berechtigung zum Schreiben von Abrechnungsdaten in eine Tabelle hat. Das Dienstkonto:
cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com
Dieses Dienstkonto benötigt die vordefinierte Rolle roles/bigquery.dataEditor
, um Exporte zuzulassen. 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 ist, die wiederum in kleinere Cluster unterteilt sind.
Wenn Sie Partitions- und Clusterschlüssel in einer Abfrage verwenden, kann BigQuery die relevanten Daten schnell finden. Dadurch lassen sich die Kosten der Abfrage erheblich senken.
Diese Abfrage ist beispielsweise im Vergleich zu einer Abfrage ohne Partitions- und Clusteringschlüssel effizient:
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:
- Partitionierte Tabellen abfragen
- Geclusterte Tabellen abfragen
- Abfrageleistung optimieren
- Best Practices für die Kostenkontrolle in BigQuery
Rechnungskonto-ID des Zahlungspflichtigen ermitteln
Die Rechnungskonto-ID des Zahlungspflichtigen finden Sie auf der Seite „Rechnungskonten“ der Partner Sales Console. Klicken Sie dazu auf den Tab Partnerabrechnung.
Sie sehen alle Rechnungskonten und die IDs der Rechnungskonten der Zahlungspflichtigen.
Zugriffssteuerungen für andere Nutzer für das exportierte Dataset einrichten
Es gibt mehrere Möglichkeiten, Zugriffssteuerungen für die Daten im BigQuery-Export einzurichten. Weitere Informationen finden Sie unter Zugriffssteuerungen in BigQuery.
Damit Nutzer nur auf Daten zugreifen können, für die sie berechtigt sind, empfehlen wir, autorisierte Ansichten einzurichten, um Daten aus Ihrem exportierten Datenpool freizugeben.
Achten Sie beim Einrichten von Berechtigungen für Nutzer für den kontinuierlichen Datenexport darauf, dass das Dienstkonto cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com
immer vollen Bearbeiterzugriff auf das Export-Dataset hat.
Tabellenschema
Im folgenden Schema werden die Daten in der BigQuery-Tabelle beschrieben.
In Ihrem BigQuery-Dataset wird der detaillierte Rebilling-Export in die Datentabelle 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 hat beispielsweise den Typ Standard Storage US. |
usage_start_time
|
Zeitstempel | Die Startzeit des stündlichen Nutzungszeitraums, für den die berechneten Kosten gelten. Nutzung und Kosten werden für alle Dienste mit stündlicher Genauigkeit angezeigt. Eine lange Dauer der Dienstnutzung verteilt sich so auf mehrere Stundenzeitfenster. Bei Aboprodukten ist das der Beginn des Abrechnungsmonats. |
usage_end_time
|
Zeitstempel | Die Endzeit des stündlichen Nutzungszeitraums, für den die berechneten Kosten gelten. Nutzung und Kosten werden für alle Dienste mit stündlicher Genauigkeit angezeigt. Eine lange Dauer der Dienstnutzung verteilt sich so 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 Vorfahren 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. Für Ressourcen ohne bestimmten Standort wird global angezeigt. 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, ist 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 | Hier werden die Struktur und der Wert von Informationen beschrieben, 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 erstellt 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 Gutschriften. Wenn Sie die Gesamtkosten einschließlich Gutschriften berechnen möchten, müssen Sie credits.amount zu cost hinzufügen.
|
currency
|
String | Die Währung, in der die Kosten abgerechnet werden. Weitere Informationen zur Landeswährung für Abrechnung und Zahlungen |
currency_conversion_rate
|
Float | Der Wechselkurs von US-Dollar in die Landeswährung. cost ÷ currency_conversion_rate sind also die 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 usage.pricing_unit -Nutzung.
|
usage.pricing_unit
|
String | Die Maßeinheiten für die Ressourcennutzung. |
credits
|
Struct, wiederholt | Enthält Felder, die die Struktur und den Wert von Gutschriften beschreiben. |
credits.id
|
String | Wenn ein Wert angegeben ist, 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 angerechnet 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 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 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 Korrektur an Kostenpositionen beschreiben. |
adjustmentsInfo.adjustment_id
|
String | Wenn ein Wert angegeben ist, ist eine Korrektur mit einer Kostenposition verknüpft. adjustmentsInfo.adjustments_id ist die eindeutige ID für alle Anpassungen, die durch ein Problem verursacht wurden.
|
adjustmentsInfo.adjustment_description
|
String | Eine Beschreibung der Korrektur und ihre Ursache. |
adjustmentsInfo.adjustment_type
|
String | Der Typ 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. Sie haben 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. Sie haben 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 identifiziert wird, 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 . Sie haben das Format accounts/{account}/customers/{customer}/customerRepricingConfigs/{id} .
|
channel_partner_repricing_config_name
|
String | (Nur für Distributoren) Der Ressourcenname der Cloud Channel API ChannelPartnerRepricingConfig . Sie haben 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 an einen Tag-Schlüssel angehängten Ressourcen. 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 den Tag-Schlüssel und die Tag-Werte definiert. Namespace kann mit den Tag-Schlüssel- und Tag-Wert-Kurznamen kombiniert werden, um einen global eindeutigen und voll qualifizierten Namen für den Tag-Schlüssel oder den Tag-Wert zu erstellen. |
customer_correlation_id
|
String | Die externe CRM-ID des 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 | Der für die Nutzung berechnete Preis. |
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 den 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. |
transaction_type
|
String | Der Transaktionstyp des Verkäufers. Folgende Transaktionstypen sind möglich:
|
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. |
Zusätzliche Hinweise zum Schema
Es gibt einige zusätzliche Hinweise zum Schema.
Spalten, die für Google Workspace nicht gelten
Wenn eine Spalte oder ein Feld nicht für eine Produktfamilie gilt, enthält das Feld in den exportierten Daten für diese Produktfamilie null
. Die folgenden Felder gelten nicht für Google Workspace-Exporte:
project
labels
resource
credits
adjustmentsInfo
customer_repricing_config_name
channel_partner_repricing_config_name
tags
price.effective_price
price.tier_start_amount
transaction_type
seller_name
Spalten, die nicht für Offlinebestellungen gelten (Vorabversion)
Wenn eine Spalte oder ein Feld nicht für eine Produktfamilie gilt, enthalten die exportierten Daten für diese Produktfamilie in dieser Spalte oder diesem Feld null
. Die folgenden Spalten oder Felder gelten nicht für Exporte der Abrechnung 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
transaction_type
seller_name
Weitere Hinweise zum Exportieren in Google Workspace
Bei Google Workspace-Exporten gibt es mehrere Besonderheiten:
- Die Google Workspace-Daten enthalten nicht die eigene Nutzung des Resellers.
- Wenn
cost_type
tax
undadjustment
ist, istusage.amount_in_pricing_units
immer 1. - Auf Google Workspace-Rechnungen werden Steuern als einzelne Position aufgeführt. Im Export werden Steuern nach Kunden aufgeschlüsselt. Die Gesamtsteuer sollte mit der Rechnung übereinstimmen. Bei den einzelnen Steuern kann es jedoch zu geringfügigen Abweichungen durch Rundungen kommen.
billing_account_id
- Bei Google Cloud ist dies das Cloud-Rechnungskonto, mit dem die Nutzung verknüpft ist.
- Bei Google Workspace ist dies die Cloud Identity des Kunden.
- Bei Offlinebestellungen ist dies der Name des Kunden.
service
und sku
Bei Google Workspace stehen diese Spalten für „Produkt“ und „Artikelnummer“, die mit der Nutzung verknüpft sind. Weitere Informationen zu Produkt- und SKU-IDs
usage_start_time
und usage_end_time
In der CSV-Rechnung für Google Workspace werden diese als Datumsangaben dargestellt. In den Exporten werden diese als Zeitstempel dargestellt:
- Für
usage_start_time
ist dies der Startzeitpunkt (einschließlich) des Abos, also 00:00 Uhr (PST) am Startdatum. - Für
usage_end_time
ist dies das Ende des Abos (exklusiv) um 0:00 Uhr PST am Tag nach dem Enddatum.
project.labels
Bei Google Cloud sind dies die Schlüssel/Wert-Paare im Google Cloud-Projekt, in dem die Nutzung stattgefunden hat. Weitere Informationen finden Sie im Hilfeartikel Labels erstellen und verwalten.
labels
Bei Google Cloud sind dies die Schlüssel/Wert-Paare der Google Cloud-Ressource, in der die Nutzung stattgefunden hat. Weitere Informationen finden Sie im Hilfeartikel Labels erstellen und verwalten.
system_labels
Bei Google Cloud sind dies die Schlüssel/Wert-Paare der Google Cloud-Ressource, in der die Nutzung stattgefunden hat. Weitere Informationen finden Sie unter Verfügbare Systemlabels.
Bei Google Workspace sind dies 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 der Bestellung.workspace.googleapis.com/subscription_id
: Die Abo-ID.workspace.googleapis.com/usage_type
: Die Art der Nutzung. Nicht zutreffend, wenncost_type
nichtregular
ist.
Zu den Google Workspace-Nutzungsarten gehören:
COMMITMENT_TERM_START_ITEM
: Beginn eines Abos. In der Regel wird ein Teil des Monats für ein Abo mit monatlicher Abrechnung und für den Abrechnungszeitraum oder Vertragszeitraum für ein Abo mit Vorauszahlung berechnet.COMMITMENT_TERM_END_ITEM
: Ende eines Abos. In der Regel mit den Kosten des letzten Monats eines monatlich abgerechneten Abos mit Bindung verbunden.COMMITMENT_TERM_RENEWAL_ITEM
: Beginn eines Folgeabozeitraums.COMMITMENT_MONTHLY_ITEM
: Nutzung, die für Verpflichtungen erfasst wurde, die zu Beginn des Monats bestanden. In den meisten Fällen wird die Gebühr über den gesamten Monat verteilt.COMMITMENT_SEATS_CHANGE_ITEM
: Wird erfasst, wenn sich die Bindungsebene ändert (entweder erhöht oder verringert). Beginnt oft Mitte des Monats und dauert bis zum Monatsende bei einem Abo mit monatlicher Abrechnung oder bis zum Ende des Abrechnungs- oder Vertragszeitraums bei einem vorausbezahlten Abo.COMMITMENT_CANCEL_ITEM
: Wird erfasst, wenn ein Abo gekündigt wird. Beinhaltet Gebühren im Zusammenhang mit einer vorzeitigen Kündigung. Entweder eine Gebühr für die verbleibende Vertragslaufzeit, wenn der Vertrag vorzeitig gekündigt wird, oder eine Gutschrift für den Rest des Abrechnungszeitraums, wenn ein Vertrag vorzeitig geändert oder gekündigt wird.FLEXIBLE_SEATS_ITEM
: Hier werden die Nutzung durch eine bestimmte Anzahl von Nutzern für einen zusammenhängenden Block von einigen Tagen erfasst. Nur für Nutzer ohne Bindung gedacht.COUPON_DISCOUNT_ITEM
: Der Rabattbetrag, der mit einem Gutschein verknüpft ist.MIGRATED_CREDIT_ITEM
: Guthaben aus der Postini-Migration.COMMITMENT_PREPAY_BILLING_PERIOD_ITEM
: Stellt Nutzungsinformationen dar, die zu Beginn des Abrechnungszeitraums für den gesamten Zeitraum für ein Abo mit Vorauszahlung und Bindung erstellt werden.
usage.amount
Bei der lizenzbasierten Nutzung von Google Workspace gibt dies die Anzahl der bezahlten Lizenzen an. z. B. vergebene Lizenzen bei Verträgen oder die Anzahl der Lizenzen, die beim flexiblen Tarif bezahlt werden.
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
Bei Google Cloud ist dies entweder eine eindeutige alphanumerische Kennung (12-b34-c56-d78) oder eine Beschreibung des Guthabentyps (Rabatt für zugesicherte Nutzung: CPU). Ist das Feld credits.id
leer, ist der Produkt-SKU keine Gutschrift zugeordnet.
credits.full_name
Bei Google Cloud ist dies eine für Menschen lesbare Beschreibung einer alphanumerischen credits.id
. Beispiele sind Guthaben für den kostenlosen Testzeitraum oder ausgabenbasierte Rabatte für die 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 Gutschriftstyps ist (z. B. Rabatt für zugesicherte Nutzung: CPU), dann ist das Feld credits.full_name
leer.
credits.type
Für Google Cloud gibt 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 kostenlosen Testzeitraum von Google Cloud, Gutschriften für Marketingkampagnen oder andere Zuwendungen zur Nutzung von Google Cloud. Angebotsgutschriften werden als Zahlungsart betrachtet und automatisch angewendet, um die Gesamtkosten zu reduzieren.RESELLER_MARGIN
: Wenn Sie Reseller sind, zeigt der Gutschriftentyp Reseller-Margin 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
Bei Google Cloud werden 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 Cloud gilt Folgendes:
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 als Dritter für einen Vertrag ausgestellt wird.SLA_VIOLATION
: Eine Gutschrift, die 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 Cloud gilt Folgendes:
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 Werbebuchungen mit aktualisierter Nutzung und Kosten korrigiert.COMPLETE_NEGATION
: Bei der Korrektur werden die ursprüngliche Nutzung und die Kosten vollständig geschätzt. Weitere Informationen werden nicht wieder monetarisiert.MANUAL_ADJUSTMENT
: Die Anpassung wird manuell Kosten und Nutzung zugeordnet.
price.effective_price
Bei Google Cloud ist dies der Preis für die Nutzung der Google Cloud- oder Google Maps Platform-SKUs und die SKU-Preisstufen. Wenn Ihr Cloud-Rechnungskonto benutzerdefinierte Vertragspreise enthält, ist dieser Preis für Ihr Cloud-Rechnungskonto spezifisch. Andernfalls ist dies der Listenpreis der SKU oder SKU-Stufe.