このページでは、Channel Services のエクスポートを構成する方法と、エクスポートに使用できるスキーマについて説明します。
BigQuery を使用すると、チャネル サービスの請求データを特定の BigQuery データセットにエクスポートできます。このデータは、顧客やチャネル パートナーが提供するサービスをどのように使用しているかを詳細に分析するのに役立ちます。
チャネル サービスからのエクスポートには、Cloud Billing のエクスポートには含まれていない、販売パートナー固有のデータが含まれます。これには、構成された料金変更ルールでの費用、クレジット、使用状況データが含まれます。これらのエクスポートでは、顧客の親の請求先アカウントに関するすべての情報が 1 つのデータセットに集約されます。
ただし、チャネル サービス エクスポートのデータは Cloud Billing エクスポートと互換性があり、クエリを使用して両方のデータセットを結合して分析できます。
販売パートナー以外の Cloud Billing のエクスポートについては、BigQuery への Cloud Billing のエクスポートの設定をご覧ください。
準備
チャネル サービスの課金データのエクスポートを開始する前に、次の手順を実施する必要があります。
- BigQuery データセットをホストするプロジェクトを設定します。プロジェクトで課金が有効になっていることを確認します。
- プロジェクトで BigQuery Data Transfer Service API を有効にします。
- エクスポートしたデータ用のデータセットを作成します。
Cloud Billing データのエクスポートのプロジェクトと BigQuery データセットがすでにある場合は、そのプロジェクトとデータセットをチャネル サービス エクスポートに再利用できます。
プロジェクトとデータセットの設定の詳細については、「BigQuery への Cloud Billing データのエクスポートの設定」をご覧ください。
エクスポートに必要な権限
チャネル サービスのエクスポートを有効化および構成するには、次のロールが必要です。
BigQuery では、ターゲット データセットを作成した場合は、データセットを含むプロジェクトに対する
BigQuery User
が必要になります。データセットが他のユーザーによって作成された場合は、BigQuery Data Owner
ロールが必要です。Google Cloud のエクスポートを有効にするには、Partner Sales Console で Google Cloud 販売パートナー管理者ロールが必要です。
Google Workspace のエクスポートを有効にするには、販売パートナー管理者または Google Workspace の請求権限が必要になります。
(省略可)ターゲット BigQuery データセットが含まれるプロジェクトの場合、プロジェクトで課金が有効になっているかどうかを自動的に確認するために
Project Viewer
が必要です。
プロジェクトとデータセットを選択する
Partner Sales Console で、Channel サービス データを格納する BigQuery のプロジェクトとデータセットを選択します。まだ有効になっていない場合は、プロジェクトで課金を有効にします。
BigQuery データセットを選択または作成するときに、データセットにサポートされている BigQuery ロケーションのいずれかを選択できます。データソースごとにチャネル サービス データのエクスポートを初めて有効にする場合(Google Cloud または Google Workspace):
マルチリージョン ロケーションを使用するように BigQuery データセットを構成すると、前月の初日からの選択した各データソースに対して BigQuery エクスポート データを利用できます。たとえば、9 月 23 日に BigQuery エクスポートを有効にすると、エクスポートには 8 月 1 日以降のデータが含まれます。
リージョン ロケーション(マルチリージョンの米国または EU 以外)を使用するように BigQuery データセットを構成すると、エクスポートを有効にした日付以降からの選択した各データソースに対して BigQuery エクスポート データを利用できます。つまり、マルチリージョン以外のデータセットのロケーションの場合、BigQuery のエクスポート データが過去にさかのぼって追加されることはなく、エクスポートを有効にする前の BigQuery エクスポート データは表示されません。
複数の Partner Sales Console アカウントの課金データをエクスポートするには、次の手順を行います。
- データをエクスポートする BigQuery データセットで、各パートナー セールス コンソール アカウントの課金管理者にデータセットを表示する権限があることを確認します。
- 各 Partner Sales Console アカウントで請求データのエクスポートを設定する際は、統合データセットを選択します。
サポートされている BigQuery ロケーション
マルチリージョン
次の表は、チャネル サービスの BigQuery データのエクスポートをサポートしているマルチリージョンを示しています。
マルチリージョンの説明 | マルチリージョン名 |
---|---|
欧州連合の加盟国内のデータセンター1 | EU |
米国内のデータセンター | US |
リージョン
次の表は、チャネル サービスの BigQuery データのエクスポートをサポートしている南北アメリカのリージョンを示しています。
リージョンの説明 | リージョン名 |
---|---|
アイオワ | us-central1 |
ラスベガス | us-west4 |
ロサンゼルス | us-west2 |
モントリオール | northamerica-northeast1 |
北バージニア | us-east4 |
オレゴン | us-west1 |
ソルトレイクシティ | us-west3 |
サンパウロ | southamerica-east1 |
サウスカロライナ | us-east1 |
次の表は、チャネル サービスの BigQuery データのエクスポートをサポートしているアジア太平洋のリージョンを示しています。
リージョンの説明 | リージョン名 |
---|---|
香港 | asia-east2 |
ジャカルタ | asia-southeast2 |
ムンバイ | asia-south1 |
大阪 | asia-northeast2 |
ソウル | asia-northeast3 |
シンガポール | asia-southeast1 |
シドニー | australia-southeast1 |
台湾 | asia-east1 |
東京 | asia-northeast1 |
次の表は、チャネル サービスの BigQuery データのエクスポートをサポートしているヨーロッパのリージョンを示しています。
リージョンの説明 | リージョン名 |
---|---|
ベルギー | europe-west1 |
フィンランド | europe-north1 |
フランクフルト | europe-west3 |
ロンドン | europe-west2 |
オランダ | europe-west4 |
ワルシャワ | europe-central2 |
チューリッヒ | europe-west6 |
エクスポートを有効にする
データ エクスポートを有効にする前に、PROJECT_ID:DATASET_NAME という形式の完全修飾データセット ID をメモします。
チャネル サービスのエクスポートを有効にするには:
- Partner Sales Console で、[請求] ページを開きます。
- [課金データのエクスポート] を選択します。
- [再請求データセット] フィールドに完全修飾データセット ID を入力します。
- データをエクスポートするデータソースを選択します。
- [更新] をクリックします。データセットの権限を更新するプロンプトが表示された場合は、[更新] をクリックします。
設定後、課金データのエクスポートでは、毎日の使用状況データが提供されます。エクスポート表は、アカウントの請求書エクスポートが初めて実行されるまで表示されません。データセットには、データを保持するように最初に構成されたときのデータが含まれています。
データセットへの再請求の費用データのエクスポートを停止するには、[顧客の再請求] ページで [課金データのエクスポートを無効にする] をクリックします。エクスポートを再度有効にするには、前のステップに沿ってデータセット ID を指定します。
価格再設定が無効になっていた間は、価格再設定を使用できません。その期間にエクスポートされたデータを削除した場合、削除されたレコードをバックフィルすることはできません。
必要なサービス アカウントの権限
チャネル サービス データのエクスポートでは、Google が所有および管理し、課金レコードをテーブルに書き込む権限があるサービス アカウントが使用されます。このサービス アカウント は次のとおりです。
cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com
このサービス アカウントには、エクスポートを許可する事前定義ロール: roles/bigquery.dataEditor
が必要です。権限を構成するには、エクスポートを有効にする手順を行います。
データを効率的にクエリする
BigQuery テーブルは、デフォルトで export_time
によってパーティション分割され、payer_billing_account_id
によってクラスタ化されます。つまり、テーブルは小さなパーティションに分割され、各パーティションはさらに小さなクラスタに分割されます。
クエリでパーティション キーとクラスタキーを使用すると、BigQuery で関連データを迅速に特定でき、クエリの費用を大幅に削減できます。
たとえば、次のクエリは、パーティショニングやクラスタリング キーを使用しないクエリに比べて効率的です。
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;
パーティショニング、クラスタリング、ベスト プラクティスの詳細については、次のリンクをご覧ください。
支払人の請求先アカウント ID の確認
支払い者の請求先アカウント ID を確認するには、[Partner Sales Console] の [請求先アカウント] ページを開き、[パートナー請求] タブをクリックします。
すべての請求先アカウントと支払者の請求先アカウント ID を確認できます。
エクスポート データセットに対する他のユーザーのアクセス制御を設定する
BigQuery エクスポートのデータにアクセス制御を設定するには、複数の方法があります。詳細については、BigQuery のアクセス制御をご覧ください。
ユーザーが表示を許可されているデータにのみアクセスできるようにするには、エクスポートされたデータセットからデータを共有するように承認済みビューを設定することをお勧めします。
ユーザーの権限を設定する間、継続的なデータ エクスポートを行うために、サービス アカウント cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com
にエクスポート データセットに対する完全な編集者アクセス権が常に付与されていることを確認してください。
テーブル スキーマ
次のスキーマは、BigQuery テーブルのデータを記述します。
BigQuery データセットで、詳細な再請求データのエクスポートが reseller_billing_detailed_export_v1
という名前のデータテーブルに読み込まれます。
フィールド | タイプ | 説明 |
billing_account_id
|
String(文字列) | 使用量が関連付けられているアカウント ID。顧客の ID または自分のものになります。プロダクト ファミリーに応じて、これは請求先アカウントまたは Cloud Identity ID になります。 |
payer_billing_account_id
|
String(文字列) | 親の請求先アカウントの ID。 |
invoice.month
|
String(文字列) | 費用項目を含む請求書の年と月(YYYYMM)。 たとえば、「202101」は 2021 年 1 月と同じです。 |
cost_type
|
String(文字列) | この明細が表す費用のタイプ(通常、税、調整、または丸め誤差)。 |
service.id
|
String(文字列) | 使用量が関連付けられているサービスの ID。 |
service.description
|
String(文字列) | 課金データをレポートした Google サービス。 |
sku.id
|
String(文字列) | サービスで使用されるリソースの SKU ID。 |
sku.description
|
String(文字列) | サービスで使用されるリソースタイプの説明。 たとえば、Cloud Storage は Standard Storage US タイプです。 |
usage_start_time
|
タイムスタンプ | 計算された費用の使用時間の開始時刻。すべてのサービスの使用量と費用は、時間単位で表示されます。長時間実行されるサービスの使用量は、複数の時間単位のウィンドウにまたがります。定期購入商品の場合は請求月の初日です。 |
usage_end_time
|
タイムスタンプ | 計算された費用の使用時間の終了時刻。すべてのサービスの使用量と費用は、時間単位で表示されます。長時間実行されるサービスの使用量は、複数の時間単位のウィンドウにまたがります。定期購入商品の場合は請求月の末日です。 |
project
|
構造体 | Cloud Billing データを生成した Google Cloud プロジェクトに関する情報。 |
project.number
|
String(文字列) | Cloud Billing データを生成した Google Cloud プロジェクトの一意の識別子(内部で生成されて匿名化される)。 |
project.id
|
String(文字列) | Cloud Billing データを生成した Google Cloud プロジェクトの ID。 |
project.name
|
String(文字列) | Cloud Billing データを生成した Google Cloud プロジェクトの名前。 |
project.labels
|
構造体、繰り返し | |
project.labels.key
|
String(文字列) | ラベルが存在する場合、Key-Value ペアの key の部分です。 |
project.labels.value
|
String(文字列) | ラベルが存在する場合、Key-Value ペアの value の部分です。 |
project.ancestry_numbers
|
String(文字列) | project.id で識別されるプロジェクトのリソース階層の祖先。
|
labels
|
構造体、繰り返し | |
labels.key
|
String(文字列) | ラベルが存在する場合、Key-Value ペアの key の部分です。 |
labels.value
|
String(文字列) | ラベルが存在する場合、Key-Value ペアの value の部分です。 |
system_labels
|
構造体、繰り返し | |
system_labels.key
|
String(文字列) | システムラベルが存在する場合、Key-Value ペアの key の部分です。 |
system_labels.value
|
String(文字列) | システムラベルが存在する場合、Key-Value ペアの value の部分です。 |
location.location
|
String(文字列) | 使用量が発生した国、リージョンまたはゾーンレベルでのロケーション。特定のロケーションがないリソースには global が表示されます。詳細については、リージョンとゾーンをご覧ください。 |
location.country
|
String(文字列) | location.location が国、リージョンまたはゾーンの場合、このフィールドは使用量が発生した国です。たとえば、US のようにします。詳細については、リージョンとゾーンをご覧ください。 |
location.region
|
String(文字列) | location.location が国またはリージョンの場合、このフィールドは使用量が発生したリージョンです。たとえば、us-central1 のようにします。詳細については、リージョンとゾーンをご覧ください。 |
location.zone
|
String(文字列) | location.location がゾーンの場合、このフィールドは使用量が発生したゾーンです。たとえば、us-central1-a のようにします。詳細については、リージョンとゾーンをご覧ください。 |
resource
|
構造体 | サービスの使用量を生成するサービス リソース(仮想マシンや SSD など)に関連する情報の構造と値を記述します。 |
resource.name
|
String(文字列) | 関連する使用量を生成したリソースのサービス固有の ID。ユーザー作成の場合があります。 |
resource.global_name
|
String(文字列) | 関連する使用量を生成したリソースのグローバルで一意なサービス ID。 |
cost
|
数値 | クレジットが適用される前の使用料。クレジットを含む合計費用を算出するには、credits.amount を cost に追加します。
|
currency
|
String(文字列) | 費用の請求通貨。詳しくは、現地通貨での請求と支払いをご確認ください。 |
currency_conversion_rate
|
浮動小数点数 | 米ドルから現地通貨への為替レート。つまり、cost ÷ currency_conversion_rate が米ドルでの金額になります。 |
usage.amount
|
数値 | 使用された usage.unit の量。
|
usage.unit
|
String(文字列) | リソースの使用量を測定する基本単位。たとえば、Standard Storage の基本単位はバイト/秒です。 |
usage.amount_in_pricing_unit
|
数値 | usage.pricing_unit の使用量。 |
usage.pricing_unit
|
String(文字列) | リソースの使用量を測定する単位。 |
credits
|
構造体、繰り返し | クレジットの構造と値を記述するフィールドが含まれます。 |
credits.id
|
String(文字列) | 入力されている場合は、クレジットがプロダクトの SKU に関連付けられていることを示します。 |
credits.full_name
|
String(文字列) | プロダクトの SKU に関連付けられたクレジットの名前。 |
credits.type
|
String(文字列) | このフィールドは、credits.id の目的または送信元を示します。
|
credits.name
|
String(文字列) | 使用量に適用されるクレジットの説明。 |
credits.amount
|
数値 | 使用量に適用されるクレジットの金額。 |
credits.channel_partner_amount
|
数値 | マークアップと割引を再請求した後に、使用量に適用されるクレジットの金額。channel_partner_name と関連する ChannelPartnerRepricingConfig に基づきます。credits.type が RESELLER_MARGIN の場合、この金額はゼロになります。 |
credits.customer_amount
|
数値 | マークアップと割引を再請求した後に、使用量に適用されるクレジットの金額。customer_name と関連する CustomerRepricingConfig に基づきます。credits.type が RESELLER_MARGIN の場合、この金額はゼロになります。 |
adjustmentsInfo
|
構造体、繰り返し | 費用項目に対する調整の構造と値を記述するフィールドが含まれます。 |
adjustmentsInfo.adjustment_id
|
String(文字列) | 入力されている場合、調整が費用項目に関連付けられます。adjustmentsInfo.adjustments_id は、問題によって発生したすべての調整の一意の ID です。 |
adjustmentsInfo.adjustment_description
|
String(文字列) | 調整と原因の説明。 |
adjustmentsInfo.adjustment_type
|
String(文字列) | 調整のタイプ。 |
adjustmentsInfo.adjustment_mode
|
String(文字列) | 調整の方法。 |
export_time
|
タイムスタンプ | 課金データの追加に関連する処理時間。この時間は、新しくエクスポートを行うたびに増加します。 エクスポートされた課金データが最後に更新された日時を確認するには、export_time 列を使用してください。
|
entitlement_name
|
String(文字列) | Cloud Channel API Entitlement のリソース名。accounts/{account}/customers/{customer}/entitlements/{entitlement} の形式を使用します。
|
channel_partner_name
|
String(文字列) | (ディストリビューターのみ)エンド カスタマーに販売するチャネル パートナーのリソース名。accounts/{account}/channelPartnerLinks/{channelPartner} の形式を使用します。
|
channel_partner_cost
|
数値 | (ディストリビュータのみ)既存の ChannelPartnerRepricingConfig の適用後、channel_partner_name で識別されるチャネル パートナーが負担する費用。 |
customer_name
|
String(文字列) | この使用量を消費した、販売パートナーの 顧客のリソース名。形式は accounts/{account}/customers/{customer} です。 |
customer_cost
|
数値 | CustomerRepricingConfig の適用後、customer_name 列によって識別される販売パートナーの顧客が負担する費用(存在する場合)。
|
cost_at_list
|
数値 | 公開価格設定で課金される場合の費用。 |
customer_repricing_config_name
|
String(文字列) | Cloud Channel API CustomerRepricingConfig のリソース名。accounts/{account}/customers/{customer}/customerRepricingConfigs/{id} の形式を使用します。
|
channel_partner_repricing_config_name
|
String(文字列) | (ディストリビューターのみ)Cloud Channel API ChannelPartnerRepricingConfig のリソース名。accounts/{account}/channelPartnerLinks/{channelPartner}/channelPartnerRepricingConfigs/{id} の形式を使用します。
|
tags
|
構造体 | キー、値、名前空間などのタグを記述するフィールド。 |
tags.key
|
String(文字列) | この特定のタグに関連付けられたキーの略称または表示名。 |
tags.value
|
String(文字列) | タグキーにアタッチされたリソース。特定のキーのリソースにアタッチできる値は、常に 1 つだけです。 |
tags.inherited
|
ブール値 | タグ バインディングが継承されるか(Tags Inherited = True)、直接 / 非継承か(Tags Inherited = False)を示します。 |
tags.namespace
|
String(文字列) | タグキーと値を定義するリソース階層を表します。名前空間をタグキーとタグ値の略称と組み合わせることで、タグキーまたはタグ値にグローバルに一意の完全修飾名を作成できます。 |
customer_correlation_id
|
String(文字列) | お客様の外部 CRM ID。この顧客の CRM ID が存在する場合にのみ入力されます。 |
price
|
構造体 | 使用量に対して請求される料金に関連する構造と値を記述するフィールド。 |
price.effective_price
|
数値 | 使用量に対して請求される料金。 |
price.tier_start_amount
|
数値 | SKU の料金ティアの下限の単位。たとえば、0~100 ユニット、101~1,000 ユニット、1,001 以上のユニットなど、3 つの料金階層がある SKU では、SKU の料金階層の開始単位数量を表す price.tier_start_amount フィールドに、SKU の 3 つの料金行(0、101、1,001)が表示されます。Google Cloud の料金の詳細 |
price.unit
|
String(文字列) | 料金が指定され、リソースの使用量が測定される単位(ギビバイト、テビバイト、月、年、ギビバイト時間、ギビバイト月、カウントなど)。price.unit フィールドの値は usage.pricing_unit フィールドの値と一致します。 |
price.pricing_unit_quantity
|
数値 | SKU の料金階層の単位数量。たとえば、1,000,000 バイトあたり $1 の料金階層の場合、この列には 1,000,000 が表示されます。 |
transaction_type
|
String(文字列) | 販売者の取引タイプ。取引タイプは次のいずれかです。
|
seller_name
|
String(文字列) | 販売者の正式名称。 Google Cloud の場合、このフィールドを含むデータの最初の 1 か月は 2023 年 8 月です。 |
subscription
|
構造体 | 費用ベースまたはリソースベースのコミットメントを記述するフィールド。これらのフィールドを使用して、特定のコミットメントの料金を分析できます。 |
subscription.instance_id
|
String(文字列) | コミットメントにリンクされているサブスクリプション ID。 |
スキーマに関するその他の注意事項
Google Workspace に適用されない列
列またはフィールドがプロダクト ファミリーに適用されない場合、このプロダクト ファミリーのエクスポートされたデータには、この列 / フィールドに null
が含まれます。次の列 / フィールドは、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
Google Workspace のエクスポートに関するその他の注意事項
Google Workspace のエクスポートには、いくつかの特殊な動作があります。
- Google Workspace のデータには、販売パートナー独自の使用量は含まれません。
cost_type
がtax
およびadjustment
の場合、usage.amount_in_pricing_units
は常に 1 です。- Google Workspace の請求書では、税金は 1 つの項目として表示されます。エクスポートでは、税金は顧客別に分類されます。合計税額は ただし、個々の税金の丸め処理が若干不正確になる場合があります。
billing_account_id
- Google Cloud の場合、これは使用量が関連付けられている Cloud Billing アカウントです。
- Google Workspace の場合、これは顧客の Cloud Identity ID です。
service
と sku
Google Workspace の場合、これらの列は使用量に関連する「プロダクト」と「SKU」を表します。プロダクト ID と SKU ID の詳細。
usage_start_time
と usage_end_time
Google Workspace の請求書 CSV では、これは日付として表されます。エクスポートでは、これらはタイムスタンプとして表現されます。
usage_start_time
の場合、これはサブスクリプションの開始時刻(含む)であり、開始日の 0:00 PST です。usage_end_time
の場合、これはサブスクリプションの終了時刻(除外)であり、終了日の翌日の 0:00 PST です。
project.labels
Google Cloud の場合、これらは使用量が発生した Google Cloud プロジェクトの Key-Value ペアです。詳細については、ラベルの使用をご覧ください。
labels
Google Cloud の場合、これらは使用量が発生した Google Cloud リソースの Key-Value ペアです。詳細については、ラベルの使用をご覧ください。
system_labels
Google Cloud の場合、これらは使用量が発生した Google Cloud リソースの Key-Value ペアです。詳しくは使用可能なシステム ラベルをご覧ください。
Google Workspace の場合、費用に関する次のような追加のメタデータがあります。
workspace.googleapis.com/domain_name
: お客様のドメイン名。workspace.googleapis.com/order_id
: 注文 ID。workspace.googleapis.com/purchase_order_id
: 注文書(PO)ID。workspace.googleapis.com/subscription_id
: サブスクリプション ID。workspace.googleapis.com/usage_type
: 使用量のタイプ。該当なしcost_type
がregular
でない場合。
Google Workspace には次の使用タイプがあります。
COMMITMENT_TERM_START_ITEM
: 定期購入の開始。通常、月次請求のコミットメント サブスクリプションと、前払いサブスクリプションの請求 / 契約期間の部分的な月に関連付けられます。COMMITMENT_TERM_END_ITEM
: サブスクリプションの終了。通常、月次請求のコミットメント サブスクリプションの最終月の請求に関連付けられます。COMMITMENT_TERM_RENEWAL_ITEM
: フォローオン サブスクリプション期間の開始。COMMITMENT_MONTHLY_ITEM
: 月の初日に存在するコミットメントで記録された使用量。ほとんどの場合、料金は月全体で請求されます。COMMITMENT_SEATS_CHANGE_ITEM
: コミットメント レベルが変化(増加または減少)したときに記録されます。多くの場合、月中旬に始まり、月次請求のコミットメント サブスクリプションの場合は月末まで、前払いサブスクリプションの場合は請求 / 契約期間の終了まで続きます。COMMITMENT_CANCEL_ITEM
: 定期購入が解約されたときに記録されます。早期解約に関連する料金が含まれます。契約が途中でキャンセルされた場合は、契約期間の残り期間に対する料金、または契約が途中で変更またはキャンセルされた場合は請求期間の残り期間に対して発行されるクレジットを表します。FLEXIBLE_SEATS_ITEM
: 数日間の連続するブロックに対して、一定数のユーザーの使用量を記録します。現在、コミットメントのないユーザーのみを対象としています。COUPON_DISCOUNT_ITEM
: クーポンに関連付けられた割引額。MIGRATED_CREDIT_ITEM
: Postini の移行によるクレジット。COMMITMENT_PREPAY_BILLING_PERIOD_ITEM
: コミットメントの前払いサブスクリプションの期間全体に対して、支払い期間の開始時に作成される使用量を表します。
usage.amount
Google Workspace のシートベースの使用量の場合は、有料のシート数(コミットメントの契約シート数、フレキシブル プランの有料シート数など)を示します。
usage.pricing_unit
- Google Cloud の場合は、Cloud Billing Catalog API の詳細をご覧ください。
- Google Workspace の場合は
count
です。
credits.id
Google Cloud の場合、これは英数字の一意の識別子(12-b34-c56-d78)、またはクレジット タイプの説明(確約利用割引: CPU)です。credits.id
フィールドが空の場合、プロダクトの SKU はクレジットに関連付けられません。
credits.full_name
Google Cloud の場合、これは英数字 credits.id
を人が読める形式にした説明です。たとえば、無料トライアルのクレジットや費用ベースの確約利用割引などがあります。credits.full_name
の値は、英数字 credits.id
を持つ SKU に対してのみ入力されます。credits.id
の値がクレジット タイプの説明(確約利用割引: CPU など)の場合、credits.full_name
フィールドは空になります。
credits.type
Google Cloud の場合、クレジット タイプには次のものがあります。
COMMITTED_USAGE_DISCOUNT
: VM 使用量に応じて大幅な割引価格が適用される Compute Engine 用に購入したリソースベースの確約利用契約。COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE
: 最小限の使用量分の費用を支払うことの確約と引き換えにサービスに対して購入した費用ベースの確約利用契約。DISCOUNT
: 割引クレジットは、契約上の一定額に達した後に獲得したクレジットです。Partner Sales Console で利用可能な Cloud Billing レポートには、費用ベースの割引(契約上)と表示されます。FREE_TIER
: 一部のサービスでは、指定された上限まで無料でリソースを使用できます。これらのサービスでは、無料枠の使用量の実装にクレジットが適用されます。PROMOTION
: プロモーション クレジットのタイプには、Google Cloud の無料トライアルとマーケティング キャンペーンのクレジットや、Google Cloud を使用するためのその他の補助などがあります。利用可能な場合、プロモーション クレジットはお支払い方法とみなされ、自動的に適用されて合計請求額が下がります。RESELLER_MARGIN
: 販売パートナーの場合、販売パートナーのマージンのクレジットのタイプは、すべての有効な項目で獲得された販売パートナー プログラム割引であることを示します。SUBSCRIPTION_BENEFIT
: 割引の代わりにサービスへの長期サブスクリプションを購入することで獲得したクレジット。SUSTAINED_USAGE_DISCOUNT
: 継続利用割引クレジットのタイプは、特定の Compute Engine リソースの実行が請求月の大きな割合を占めることで獲得する、自動的に適用される割引です。
adjustmentsInfo
Google Cloud の場合、これらの値は、Cloud Billing の変更に対して費用項目が生成された場合にのみ入力されます。adjustmentsInfo
タイプには、調整の詳細情報(調整がエラーの修正または他の理由で行われたかどうか)が含まれます。
adjustmentsInfo.adjustment_type
Google Cloud の場合、これには以下のものが含まれます。
USAGE_CORRECTION
: 使用量報告の誤りに伴う修正。PRICE_CORRECTION
: 価格設定ルールの誤りに伴う修正。METADATA_CORRECTION
: 費用を変更せずにメタデータを訂正する修正。GOODWILL
: お客様の信用に応じて発行されるクレジット。SALES_BASED_GOODWILL
: 契約の一部として顧客の信用に応じて発行されるクレジット。SLA_VIOLATION
: サービスレベル目標(SLO)違反のためユーザーに発行されるクレジット。BALANCE_TRANSFER
: 1 つのお支払いアカウントから別のお支払いアカウントに資金移動するときの調整。ACCOUNT_CLOSURE
: 閉鎖された口座の残高をゼロにする調整。GENERAL_ADJUSTMENT
: 一般的な請求先アカウントの変更。
adjustmentsInfo.adjustment_mode
Google Cloud の場合、これには以下のものが含まれます。
PARTIAL_CORRECTION
: 元の使用量と費用を部分的に無効にする修正。COMPLETE_NEGATION_WITH_REMONETIZATION
: 元の使用量と費用を完全に無効にし、更新された使用量と費用を含む修正後の項目を発行する修正。COMPLETE_NEGATION
: 元の使用量と費用を完全に無効にし、それ以上使用しても費用は再収益化されない修正。MANUAL_ADJUSTMENT
: 調整は費用と使用量に手動で割り当てられます。
price.effective_price
Google Cloud の場合、これは Google Cloud または Google Maps Platform の SKU の使用量と SKU の料金階層に対して請求される料金です。Cloud Billing アカウントにカスタム契約料金がある場合、これは請求先アカウントに固有の料金です。それ以外の場合、これは SKU または SKU 階層の正規価格です。