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

このページでは、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 販売パートナー管理者ロールが必要です。

  Partner Sales Console での Google Cloud ロールの割り当てに関する詳細

• Google Workspace のエクスポートを有効にするには、販売パートナー管理者または　Google Workspace の請求権限が必要になります。

  Partner Sales Console での Google Workspace ロールの割り当てに関する詳細

• （省略可）ターゲット BigQuery データセットが含まれるプロジェクトの場合、プロジェクトで課金が有効になっているかどうかを自動的に確認するために Project Viewer が必要です。

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

Partner Sales Console で、Channel サービス　データを格納する BigQuery のプロジェクトとデータセットを選択します。まだ有効になっていない場合は、プロジェクトで課金を有効にします。

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

• [BigQuery

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

• [BigQuery

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

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

1. データをエクスポートする BigQuery データセットで、各パートナー セールス コンソール アカウントの課金管理者にデータセットを表示する権限があることを確認します。
2. 各 Partner Sales Console アカウントで課金データのエクスポートを設定するときに、統合データセットを選択します。

サポートされている BigQuery のロケーション

BigQuery がサポートするリージョンには 2 種類があります。

マルチリージョン

次の表は、チャネル サービスの BigQuery データのエクスポートをサポートしているマルチリージョンを示しています。

リージョン

次の表は、チャネル サービスの BigQuery データのエクスポートをサポートしている南北アメリカのリージョンを示しています。

次の表は、チャネル サービスの BigQuery データのエクスポートをサポートしているアジア太平洋のリージョンを示しています。

次の表は、チャネル サービスの BigQuery データのエクスポートをサポートしているヨーロッパのリージョンを示しています。

エクスポートを有効にする

データ エクスポートを有効にする前に、PROJECT_ID:DATASET_NAME という形式の完全修飾データセット ID をメモします。

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

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

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

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

エクスポート データセットに対する他のユーザーのアクセス制御を設定する

BigQuery エクスポートのデータにアクセス制御を設定するには、複数の方法があります。詳細については、BigQuery のアクセス制御をご覧ください。

ユーザーが表示を許可されているデータにのみアクセスできるようにするには、エクスポートされたデータセットからデータを共有するように承認済みビューを設定することをお勧めします。

継続的なデータ エクスポートの場合、ユーザーの権限を設定するときに、サービス アカウント cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com にエクスポート データセットに対する完全な編集者アクセス権が常に付与されていることを確認してください。

テーブル スキーマ

次のスキーマは、BigQuery テーブル内のデータを表します。

BigQuery データセットで、詳細な再請求データのエクスポートが reseller_billing_detailed_export_v1 という名前のデータテーブルに読み込まれます。

スキーマに関するその他の注意事項

スキーマに関する注意事項がいくつかあります。

Google Workspace に適用されない列

列またはフィールドがプロダクト ファミリーに適用されない場合、このプロダクト ファミリーのエクスポートされたデータには、このフィールドに null が含まれます。次のフィールドは、Google Workspace のエクスポートには適用されません。

• 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

オフライン注文に適用されない列（プレビュー版）

列またはフィールドがプロダクト ファミリーに適用されない場合、このプロダクト ファミリーのエクスポートされたデータには、この列またはフィールドに null が含まれます。次の列またはフィールドは、オフライン注文の請求エクスポートには適用されません。

• 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

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 です。
• オフライン注文の場合は、お客様の名前です。

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 の詳細をご覧ください{: track-type="tasks" class="external" track-name="externalLink" track-metadata-position="body"}
• 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: 一般的な Cloud 請求先アカウントの変更。

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 請求先アカウントにカスタム契約料金が設定されている場合、この料金は Cloud 請求先アカウントに固有のものです。それ以外の場合、これは SKU または SKU 階層の正規価格です。