將 Channel Services 資料匯出至 BigQuery

本頁說明如何設定 Channel Services 匯出作業,以及匯出作業可用的結構定義。

您可以使用 BigQuery,將 Channel Services 帳單資料匯出至指定的 BigQuery 資料集。這項資料可協助您詳細分析顧客或通路合作夥伴使用您所提供服務的方式。

Channel Services 匯出內容包含經銷商專屬資料,這些資料不會納入 Cloud Billing 匯出內容。這項資料包括費用、抵免額和用量資料,以及您設定的重新定價規則。這些匯出作業也會將客戶上層帳單帳戶的所有資訊匯總到單一資料集。

不過,Channel Services 匯出的資料與 Cloud Billing 匯出的資料相容,您可以使用查詢來彙整這兩個資料集,以進行分析。

如要瞭解非經銷商的 Cloud Billing 匯出功能,請參閱設定將 Cloud Billing 資料匯出至 BigQuery

事前準備

開始匯出 Channel Services 帳單資料前,請務必完成下列事項:

  • 設定用來代管 BigQuery 資料集的專案。請確認專案已啟用計費功能
  • 在專案中啟用 BigQuery Data Transfer Service API。
  • 為匯出的資料建立資料集。

如果您已有專案和 BigQuery 資料集,可供匯出 Cloud Billing 資料,則可將該專案和資料集用於匯出 Channel Services 資料。

如要進一步瞭解如何設定專案和資料集,請參閱「設定將 Cloud Billing 資料匯出到 BigQuery 的功能」。

匯出所需的權限

如要啟用及設定 Channel Services 匯出功能,您必須具備下列角色:

選取專案和資料集

在合作夥伴銷售控制台中,選取 BigQuery 中的專案和資料集,以便儲存 Channel Services 資料。如果尚未啟用,請為專案啟用計費功能。

選取或建立 BigQuery 資料集時,您可以為資料集選擇其中一個支援的 BigQuery 位置。首次為每個資料來源 (Google Cloud 或 Google Workspace) 啟用 Channel Services 資料匯出功能時:

  • 如果您將 BigQuery 資料集設為使用多區域位置,系統會從上個月初開始,提供每個所選資料來源的 BigQuery 匯出資料。舉例來說,如果您在 9 月 23 日啟用 BigQuery 匯出功能,匯出作業就會從 8 月 1 日開始匯出資料。

  • 如果您將 BigQuery 資料集設定為使用區域位置 (而非多區域的美國或歐盟),則啟用匯出功能後,系統會從當天起,為每個選取的資料來源提供 BigQuery 匯出資料。也就是說,系統不會回溯新增非多區域資料集位置的 BigQuery 匯出資料,因此您不會看到啟用匯出功能之前的 BigQuery 匯出資料。

如要匯出多個 Partner Sales Console 帳戶的帳單資料,請按照下列步驟操作:

  1. 在要匯出資料的 BigQuery 資料集中,請確保每個合作夥伴銷售控制台帳戶的帳單管理員都有權查看資料集。
  2. 在每個 Partner Sales Console 帳戶中設定帳單資料匯出作業時,請選取統一資料集。

支援的 BigQuery 位置

BigQuery 支援兩種區域。

多區域

下表列出支援 Channel Services BigQuery 資料匯出的多重區域。

多地區說明 多區域名稱
歐盟會員國 (外部連結)境內的資料中心 EU
美國資料中心 US

區域

下表列出美洲地區支援 Channel Services 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

下表列出歐洲地區支援 Channel Services BigQuery 資料匯出的區域。

地區說明 區域名稱
比利時 europe-west1
芬蘭 europe-north1
法蘭克福 europe-west3
倫敦 europe-west2
荷蘭 europe-west4
華沙 europe-central2
蘇黎世 europe-west6

啟用匯出功能

啟用資料匯出功能前,請記下完整資料集 ID,格式為 PROJECT_ID:DATASET_NAME

如要啟用 Channel Services 匯出功能,請按照下列步驟操作:

  1. 在 Partner Sales Console 中,開啟「帳單」頁面
  2. 選取「匯出帳單」
  3. 在「重新結算資料集」欄位中輸入完整資料集 ID。
  4. 選取要匯出資料的「資料來源」
  5. 按一下「更新」。如果出現更新資料集權限的提示,請點選「更新」

啟用重新結算匯出作業的 UI

設定完成後,帳單匯出功能每天都會提供新增的使用資料。帳戶首次執行帳單匯出作業後,匯出表格才會顯示。資料集包含首次設定保留資料時的資料。

如要停止將重新結算費用資料匯出至資料集,請在「客戶重新結算」頁面按一下「停用帳單資料匯出功能」。如要重新啟用匯出功能,請按照先前的步驟指定資料集 ID。

匯出功能停用期間,您將無法取得重新結算費用資料。如果您在該段時間內刪除任何匯出的資料,系統將無法回填已刪除的記錄。

必要的服務帳戶權限

Channel Services 資料匯出功能會使用 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 Export 中設定資料的存取權控管。詳情請參閱 BigQuery 存取權控管

為確保使用者只能存取有權查看的資料,建議您設定「授權檢視畫面」,分享匯出資料集中的資料。

如要持續匯出資料,請為使用者設定權限,並確保服務帳戶cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com一律擁有匯出資料集的完整編輯者存取權。

資料表結構定義

以下結構定義說明 BigQuery 資料表中的資料。

在您的 BigQuery 資料集中,詳細重新結算匯出檔案已載入至名為 reseller_billing_detailed_export_v1 的資料表。

欄位 類型 說明
billing_account_id String 與用量相關聯的帳戶 ID,可能是客戶或您的帳戶。視產品系列而定,這可能是指帳單帳戶或 Cloud Identity。
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 的類型為「美國地區的標準儲存空間」
usage_start_time 時間戳記 計算費用時,以小時為單位的使用期開始時間。所有服務的使用情形和費用會以精算到小時的單位顯示。執行時間長的服務使用情形會橫跨多個小時。如果是訂閱產品,這會是收款當月月初。
usage_end_time 時間戳記 計算費用時,以小時為單位使用期的結束時間。所有服務的使用情形和費用會以精算到小時的單位顯示。執行時間長的服務使用情形會橫跨多個小時。如果是訂閱產品,這會是收款當月月底。
project Struct 產生 Cloud Billing 資料的 Google Cloud 專案相關資訊。
project.number String 專案 (用於產生 Cloud Billing 資料) 的專屬匿名 ID。此為內部產生的 ID。 Google Cloud
project.id String 產生 Cloud Billing 資料的 Google Cloud 專案 ID。
project.name String 產生 Cloud Billing 資料的 Google Cloud 專案名稱。
project.labels 結構體,重複
project.labels.key String 如果有標籤,則此欄顯示的是鍵/值組合的「鍵」
project.labels.value String 如果有標籤,則此欄顯示的是鍵/值組合的「值」
project.ancestry_numbers String project.id 所識別專案的資源階層祖項。
labels 結構體,重複
labels.key String 如果有標籤,則此欄顯示的是鍵/值組合的「鍵」
labels.value String 如果有標籤,則此欄顯示的是鍵/值組合的「值」
system_labels 結構體,重複
system_labels.key String 如果有系統標籤,則此欄顯示的是鍵/值組的「鍵」
system_labels.value String 如果有系統標籤,則此欄顯示的是鍵/值組的「值」
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 Struct 說明與產生服務用量的服務資源 (例如虛擬機器或 SSD) 相關的資料結構和資訊值。
resource.name String 產生相關用量的資源專用服務 ID。可由使用者生成。
resource.global_name String 產生相關用量資源的全域專屬服務 ID。
cost 數字 適用使用模式的費用,包括與 Cloud Billing 帳戶連結合約中反映的任何議定折扣 (如適用)。
currency String 費用的帳單幣別。詳情請參閱「用當地貨幣支付帳單和付款」。
currency_conversion_rate 浮點數 美元兌當地貨幣的匯率。也就是說,cost ÷ currency_conversion_rate 等於以美元計價的費用。
usage.amount 數字 使用的 usage.unit 數量。
usage.unit String 資源用量的基本測量單位,例如標準儲存空間的基本單位為「位元組-秒」
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 Struct 描述標記的欄位,例如鍵、值和命名空間。
tags.key String 與這個特定代碼相關聯的金鑰簡短名稱或顯示名稱。
tags.value String 附加至標記鍵的資源。在任何時間點,特定鍵的資源只能附加一個值。
tags.inherited Boolean 指出標記繫結是否為沿用 (「標記沿用」= True),或直接/非沿用 (「標記沿用」= False)。
tags.namespace String 代表定義標記鍵和值的資源階層。命名空間可與標記鍵和標記值簡稱合併,為標記鍵或標記值建立全域不重複的完整名稱。
customer_correlation_id String 客戶的外部 CRM ID。只有在有這個顧客的 CRM ID 時,才會填入這個欄位。
price Struct 說明與用量收費相關結構體和值的欄位。
price.effective_price 數字 根據適用的消耗量模式計算的 SKU 價格,包括與 Cloud Billing 帳戶連結的合約中反映的任何議定折扣 (如適用)。
price.tier_start_amount 數字 SKU 價格級別的單位數量下限。詳情請參閱「關於價格等級」。
price.unit String 指定價格和測量資源用量的單位。
price.pricing_unit_quantity 數字 SKU 價格級別的單位數量下限。詳情請參閱「關於價格等級」。
price.list_price 數字 依預設耗用模式計算的 SKU 定價。
price.effective_price_default 數字 根據預設消耗模式的 SKU 價格,包括與 Cloud Billing 帳戶連結的合約中反映的任何議定折扣 (如適用)。
price.list_price_consumption_model 數字 適用消耗量模式的 SKU 定價,不含與 Cloud Billing 帳戶連結的合約中自訂價格所反映的任何議定折扣 (如適用)。
transaction_type String 賣方的交易類型。交易類型可能如下:
  • GOOGLE = 1:由 Google Cloud銷售的服務。
  • THIRD_PARTY_RESELLER = 2:由 Google Cloud轉售的第三方服務。
  • THIRD_PARTY_AGENCY = 3:合作夥伴銷售的第三方服務,由 Google Cloud 擔任代理商。
seller_name String 賣家的法定名稱。
subscription Struct 說明依據支出或資源而定的承諾使用合約的欄位。您可以使用這些欄位分析特定承諾的費用。
subscription.instance_id String 與承諾方案連結的訂閱 ID。
cost_at_effective_price_default 數字 根據預設使用模式的費用,包括與 Cloud Billing 帳戶連結的合約中反映的任何議定折扣 (如適用)。
cost_at_list_consumption_model 數字 適用使用模式的費用,不含與 Cloud Billing 帳戶連結合約中議定的任何折扣 (如適用)。
consumption_model Struct 描述適用消費模式的欄位。
consumption_model.id String 消費模式的 ID。
consumption_model.description String 消費模式的說明。

結構定義的其他注意事項

以下是結構定義的其他注意事項。

不適用於 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
  • price.list_price
  • price.effective_price_default
  • price.list_price_consumption_model
  • transaction_type
  • seller_name
  • consumption_model

不適用於 Google Workspace 以量計價型 SKU 的資料欄

如果資料欄或欄位不適用於產品系列,則該產品系列的匯出資料會在該欄位中包含 null。下列欄位不適用於 Google Workspace 匯出作業:

  • 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

不適用於離線訂單的資料欄 (預覽版)

如果資料欄或欄位不適用於產品系列,該產品系列的匯出資料會在該資料欄或欄位中包含 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
  • price.list_price
  • price.effective_price_default
  • price.list_price_consumption_model
  • transaction_type
  • seller_name
  • consumption_model

Google Workspace 匯出作業的其他注意事項

Google Workspace 匯出作業有幾項特殊行為:

  • Google Workspace 資料不包含經銷商自己的用量。
  • cost_typetaxadjustment 時,usage.amount_in_pricing_units 一律為 1。
  • Google Workspace 月結單會以單一明細列出稅金。在匯出作業中,系統會按客戶細分稅金。雖然稅金總額應與月結單相符,但個別稅金可能會有微小的四捨五入誤差。

billing_account_id

  • 如果是 Google Cloud,這是與用量相關聯的 Cloud Billing 帳戶。
  • 如果是 Google Workspace,即為客戶的 Cloud Identity。
  • 如果是離線訂單,則為顧客姓名。

servicesku

如果是 Google Workspace,這些欄代表與使用情形相關的「產品」和「SKU」。進一步瞭解產品和 SKU ID

如果是 Google Workspace 消耗型 SKU (Google Voice 和雲端硬碟),「sku.id」和「service.id」欄會包含「null」。

usage_start_timeusage_end_time

在 Google Workspace 月結單 CSV 檔案中,這會以日期表示。在匯出作業中,這些會以時間戳記表示:

  • 對於 usage_start_time,這是訂閱的開始時間 (含),即開始日期的太平洋標準時間 0:00。
  • 如果是 usage_end_time,這是指訂閱的結束時間 (不含),即結束日期隔天的太平洋標準時間 0:00。

project.labels

對於 Google Cloud,這些是產生用量的Google Cloud 專案中的鍵/值組合。詳情請參閱「使用標籤」。

labels

如果是 Google Cloud,則為產生用量的 Google Cloud資源中的鍵/值組。詳情請參閱「使用標籤」。

system_labels

  • 如果是 Google Cloud,則為產生用量的Google Cloud 資源中的鍵/值組。詳情請參閱「可用的系統標籤」。

  • 如果是 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 帳戶名額為依據,這是指付費帳戶名額。例如承諾使用價格簽訂的帳戶名額,或已付費的彈性帳戶名額數量。

如果是 Google Workspace 消耗型 SKU (Google Voice 和雲端硬碟),則為使用分鐘數。

usage.pricing_unit

  • 如要瞭解詳情,請參閱 Cloud Billing Catalog API{: track-type="tasks" class="external" track-name="externalLink" track-metadata-position="body"} Google Cloud
  • 如果是 Google Workspace,這就是 count

credits.id

如果是 Google Cloud,則為英數字元的專屬 ID (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:針對 Compute Engine 所購買的資源型承諾使用合約,以享有 VM 用量的大幅折扣價。
  • 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:將資金從一個付款帳戶轉移至其他帳戶的調整項。
  • ACCOUNT_CLOSURE:將已關閉帳戶的餘額歸零的調整項。
  • GENERAL_ADJUSTMENT:一般 Cloud Billing 帳戶修改。

adjustmentsInfo.adjustment_mode

如果是 Google Cloud,這類資訊包括:

  • PARTIAL_CORRECTION:部分否定原始用量和費用的更正。
  • COMPLETE_NEGATION_WITH_REMONETIZATION:完全否定原始用量和費用的更正,並以更新的用量和費用核發更正後的明細項目。
  • COMPLETE_NEGATION:完全否定原始用量和費用的更正,不再利用額外用量重新營利。
  • MANUAL_ADJUSTMENT:手動分配到費用和用量的調整項。

price.effective_price

對於 Google Cloud,這是指使用Google Cloud 或 Google 地圖平台 SKU 和 SKU價格層級的費用。 如果您的 Cloud Billing 帳戶有自訂合約價格,這個價格僅適用於您的 Cloud Billing 帳戶。否則,這就是 SKU 或 SKU 層級的定價