使用 Cloud Channel API 建立及管理客戶帳戶

自 2021 年 1 月起,您可以使用 Cloud Channel API 建立客戶、授權和 Cloud Billing 子帳戶。如果您目前使用 Cloud Billing API 處理這些工作,建議改用 Cloud Channel API。

本指南將介紹使用 Cloud Channel API 建立客戶和授權的基本概念。

事前準備

請先完成 Cloud Channel API 程式碼研究室,再繼續操作。這樣就能確保開發環境的設定符合程式碼範例和其他程式碼研究室的要求。

異動內容摘要

如果您目前使用 Cloud Billing API billingAccounts.create 端點建立客戶的 Cloud Billing 子帳戶,則必須開始使用 customers.create() 端點,接著使用 entitlements.create() 端點,為客戶建立新的 Cloud Billing 子帳戶。

如要管理 IAM 角色,您必須使用現有的 Cloud Billing API 端點。

建立客戶

當您準備好使用 Cloud Channel API 建立新客戶時,請使用 customers.create() 端點。開始之前,請務必備妥下列客戶資訊。

  • 主網域
  • 機構名稱
  • 地址
  • 郵遞區號 (如有)
  • 國家/地區代碼

建立客戶後,您必須確保回應的 name 欄位安全無虞,因為這是客戶的專屬 ID。

建立授權

建立客戶後,您可以使用 entitlements.create()operations.get() 端點指定 offer,為客戶設定授權。Cloud Billing 子帳戶名稱會以 provisionedService.provisioningId 的形式傳回,可搭配 Cloud Billing API 和 BigQuery 匯出功能使用。

使用 Google Cloud 優惠建立授權時,系統也會建立 Cloud Billing 子帳戶。

如需客戶和授權建立作業的詳細操作說明,包括多種語言的程式碼範例,請完成 Google Cloud 端對端佈建程式碼研究室