チャネル サービス データを BigQuery にエクスポートする

このページでは、チャネル サービス エクスポートの構成方法と、エクスポートに使用できるスキーマについて説明します。

BigQuery を使用すると、チャネル サービスの課金データを指定の BigQuery データセットにエクスポートできます。このデータは、顧客やチャネル パートナーが提供されたサービスをどのように使用しているかを詳細に分析するのに役立ちます。

チャネル サービスからのエクスポートには、Cloud Billing エクスポートに含まれない販売パートナー固有のデータが含まれます。これには、構成された料金変更ルールでの費用、クレジット、使用状況データが含まれます。これらのエクスポートでは、顧客の親の請求先アカウントに関するすべての情報が 1 つのデータセットに集約されます。

ただし、チャネル サービス エクスポートのデータは Cloud Billing エクスポートと互換性があり、クエリを使用して両方のデータセットを結合して分析できます。

販売パートナー以外の Cloud Billing エクスポートについては、BigQuery への Cloud Billing エクスポートの設定をご覧ください。

準備

チャネル サービス課金データのエクスポートを開始する前に、次のことを行う必要があります。

  • BigQuery データセットをホストするプロジェクトを設定します。プロジェクトで課金が有効になっていることを確認します
  • プロジェクトで BigQuery Data Transfer Service API を有効にします。
  • エクスポートしたデータのデータセットを作成します。

Cloud Billing データのエクスポートのプロジェクトと BigQuery データセットがすでにある場合は、そのプロジェクトとデータセットをチャネル サービス エクスポートに再利用できます。

プロジェクトとデータセットの設定について詳しくは、BigQuery への Cloud Billing データのエクスポートを設定するをご覧ください。

エクスポートに必要な権限

チャネル サービスのエクスポートを有効化および構成するには、次のロールが必要です。

プロジェクトとデータセットを選択する

Partner Sales Console で、チャネル サービス データを保存する BigQuery のプロジェクトとデータセットを選択します。プロジェクトで課金が有効になっていない場合は課金を有効にします。

BigQuery データセットを作成または選択するときに、データセットでサポートされている BigQuery ロケーションのいずれかを選択できます。データソースごとにチャネル サービス データのエクスポートを初めて有効にする場合(Google Cloud または Google Workspace):

  • マルチリージョン ロケーションを使用するように BigQuery データセットを構成すると、前月の初日からの選択した各データソースに対して BigQuery エクスポート データを利用できます。たとえば、9 月 23 日に BigQuery Export を有効にすると、エクスポートには 8 月 1 日以降のデータが含まれます。

  • リージョン ロケーション(マルチリージョンの米国または EU 以外)を使用するように BigQuery データセットを構成すると、エクスポートを有効にした日付以降からの選択した各データソースに対して BigQuery エクスポート データを利用できます。つまり、マルチリージョン以外のデータセットのロケーションの場合、BigQuery のエクスポート データが過去にさかのぼって追加されることはなく、エクスポートを有効にする前の BigQuery エクスポート データは表示されません。

複数の Partner Sales Console アカウントの課金データをエクスポートするには、次の手順を行います。

  1. データのエクスポート先の BigQuery データセットで、各 Partner Sales Console アカウントの課金管理者に、データセットの表示権限があることを確認します。
  2. 各 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 をメモします。

チャネル サービス エクスポートを有効にするには:

  1. Partner Sales Console で、[請求] ページを開きます。
  2. [課金データのエクスポート] を選択します。
  3. [再請求データセット] フィールドに完全修飾データセット ID を入力します。
  4. データをエクスポートするデータソースを選択します。
  5. [更新] をクリックします。データセットの権限を更新するプロンプトが表示された場合は、[更新] をクリックします

再請求データのエクスポートを有効にする UI

設定後、課金データのエクスポートで増分使用状況データが毎日配信されます。エクスポート テーブルは、アカウントの課金データのエクスポートを初めて実行するまで表示されません。データセットには、最初にデータを保持するように構成された時点のデータが含まれています。

データセットへの再請求の費用データのエクスポートを停止するには、[顧客の再請求] ページで [課金データのエクスポートを無効にする] をクリックします。エクスポートを再度有効にするには、前述の手順でデータセット 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;

パーティショニング、クラスタリング、ベスト プラクティスの詳細については、次のリンクをご覧ください。

  1. パーティション分割テーブルのクエリ
  2. クラスタ化テーブルのクエリ
  3. クエリ計算の最適化
  4. BigQuery の費用管理のベスト プラクティス

支払い者の請求先アカウント ID の確認

支払い者の請求先アカウント ID を確認するには、[Partner Sales Console] の [請求先アカウント] ページを開き、[パートナー請求] タブをクリックします。

すべての請求先アカウントと支払者の請求先アカウント ID を確認できます。

支払い者の請求先アカウント 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 タイムスタンプ 計算された費用の 1 時間あたりの使用ウィンドウの開始時刻。すべてのサービスの使用量と費用は、時間単位で表示されます。長時間実行されるサービスの使用量は、複数の時間単位のウィンドウにまたがります。定期購入商品の場合は請求月の初日です。
usage_end_time タイムスタンプ 計算された費用の 1 時間あたりの使用ウィンドウの終了時刻。すべてのサービスの使用量と費用は、時間単位で表示されます。長時間実行されるサービスの使用量は、複数の時間単位のウィンドウにまたがります。定期購入商品の場合は請求月の末日です。
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.amountcost に追加します。
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(文字列) 販売者の取引タイプ。取引タイプは次のいずれかです。
  • GOOGLE = 1: Google Cloud が販売するサービス。
  • THIRD_PARTY_RESELLER = 2: Google Cloud が転売するサードパーティのサービス。
  • THIRD_PARTY_AGENCY = 3: Google Cloud をエージェントとしてパートナーが販売するサードパーティのサービス。
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_typetax および adjustment の場合、usage.amount_in_pricing_units は常に 1 です。
  • Google Workspace の請求書では、税金は 1 つの項目として表示されます。エクスポートでは、税金は顧客別に分類されます。税金の合計は請求書と一致する必要がありますが、個々の税金にわずかに丸め誤差が発生することがあります。

billing_account_id

  • Google Cloud の場合、これは使用量が関連付けられている Cloud Billing アカウントです。
  • Google Workspace の場合、これは顧客の Cloud Identity ID です。

servicesku

Google Workspace の場合、これらの列は使用量に関連する「プロダクト」と「SKU」を表します。プロダクト ID と SKU ID の詳細

usage_start_timeusage_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_typeregular でない場合には適用されません。

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 階層の正規価格です。