本頁面由 Cloud Translation API 翻譯而成。

取得 Google Cloud 定價資訊

Google Cloud Pricing API 是一組 API 資源，可協助您取得 Google Cloud 服務的價格和其他資訊。

本頁面提供幾個 API 要求的範例，說明如何取得公開列出的服務和 SKU 資訊，以及只有 Cloud Billing 帳戶才能使用的服務和 SKU (這些服務和 SKU 是與 Google Cloud簽訂合約的一部分)。

您可以使用 Pricing API 取得服務清單，或特定庫存單位 (SKU) 的價格。SKU 會明確識別您可購買的資源。SKU 的範例為 Nvidia Tesla T4 GPU attached to Spot Preemptible VMs running in Warsaw。如果您有自訂價格合約，也可以使用 Pricing API 取得與 Cloud Billing 帳戶相關聯的自訂價格。

如要查看 Pricing API 的可用資源完整清單，以及要求和回應格式的詳細資訊，請參閱 API 參考資料。

事前準備

Enable the Cloud Billing API.

Enable the API

在 Google Cloud 專案中啟用 API。Pricing API 是 Cloud Billing API 的一部分。系統提示您確認要用於 Pricing API 的專案時，建議您使用Google Cloud 專案，該專案應已設定為包含 Cloud Billing 帳戶的所有 FinOps 和帳單管理需求。這個專案可以包含所有帳單專屬 API，包括 Cloud Billing API。

進一步瞭解使用以 FinOps 為重點的專案，對帳單管理用途有何好處。

取得公開服務和定價資訊

下列範例顯示可用來取得 Google Cloud 服務和 SKU 公開資訊的 API 呼叫。

如要取得公開服務、SKU 或價格的相關資訊，請建立 API 金鑰。

取得公開 Google Cloud 服務清單

以下範例列出所有公用 Google Cloud 服務，包括各項服務的中繼資料。

您不需要任何特定的 IAM 權限，即可發出這項 API 呼叫。

使用任何要求資料之前，請先替換以下項目：

API_KEY：您的 Google Cloud API 金鑰。
PAGE_SIZE (選用)：要傳回的服務數量。預設值為 50。
PAGE_TOKEN (選用)：頁面權杖，可從先前回應的 nextPageToken 取得。

HTTP 方法和網址：

GET https://cloudbilling.googleapis.com/v2beta/services?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN

如要傳送要求，請選擇以下其中一個選項：

curl

執行下列指令：

curl -X GET \
     "https://cloudbilling.googleapis.com/v2beta/services?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN"

PowerShell

執行下列指令：

$headers = @{  }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://cloudbilling.googleapis.com/v2beta/services?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN" | Select-Object -Expand Content

回應會包含服務清單，以及每項服務的相關資訊。以下範例顯示 Compute Engine 的格式。

結果會分頁顯示，每頁最多 50 項服務。回應包含 nextPageToken，可用於取得下一頁結果。如要擷取下一批結果，請設定 pageToken=PAGE_TOKEN。如要減少每頁的 SKU 數量，請設定 pageSize=PAGE_SIZE。列出所有項目後，系統不會傳回任何權杖。

{
  "services": [
    {
      "name": "services/6F81-5844-456A",
      "serviceId": "6F81-5844-456A",
      "displayName": "Compute Engine",
    },
    ...
  ]
  "nextPageToken": "alphanumeric-page-token"
}

取得公用 Google Cloud 服務的 SKU 清單

以下範例列出指定服務的公開 SKU。

您不需要任何特定的 IAM 權限，即可發出這項 API 呼叫。

使用任何要求資料之前，請先替換以下項目：

API_KEY：您的 Google Cloud API 金鑰。
FILTER：用來篩選 SKU 的服務。舉例來說，如要列出 Compute Engine 的 SKU，請使用篩選器 service="services/6F81-5844-456A"。
PAGE_SIZE (選用)：要傳回的 SKU 數量上限。預設值為 50，上限為 5000。
PAGE_TOKEN (選用)：頁面符記，位於回應的 nextPageToken 中。

HTTP 方法和網址：

GET https://cloudbilling.googleapis.com/v2beta/skus?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=FILTER

如要傳送要求，請選擇以下其中一個選項：

curl

執行下列指令：

curl -X GET \
     "https://cloudbilling.googleapis.com/v2beta/skus?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=FILTER"

PowerShell

執行下列指令：

$headers = @{  }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://cloudbilling.googleapis.com/v2beta/skus?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=FILTER" | Select-Object -Expand Content

下列回應顯示為 Compute Engine 傳回的部分範例 SKU。結果會分頁顯示，每頁最多 50 個 SKU。回應包含 nextPageToken，可用於取得下一頁結果。如要擷取下一批結果，請設定 pageToken=PAGE_TOKEN。如要變更每頁的 SKU 數量，請設定 pageSize=PAGE_SIZE。列出所有項目後，系統不會傳回任何權杖。

{
  "skus": [
    {
      "name": "skus/0008-F633-76AA",
      "skuId": "0008-F633-76AA",
      "displayName": "Example L4 GPU attached to Spot Preemptible VMs running in Hong Kong",
      "service": "6F81-5844-456A",
      "productTaxonomy": {
        "taxonomyCategories": [
          {
            "category": "GCP"
          },
          {
            "category": "Compute"
          },
          {
            "category": "GPUs"
          },
          {
            "category": "GPUs Preemptible"
          },
          {
            "category": "L4"
          }
        ]
      },
      "geoTaxonomy": {
        "type": "REGIONAL",
        "regionalMetadata": {
          "region": {
            "region": "asia-east2"
          }
        }
      }
    },
    {
      "name": "skus/000F-0B14-D302",
      "skuId": "000F-0B14-D302",
      "displayName": "Example Sole Tenancy Instance Ram running in Turin",
      "service": "6F81-5844-456A",
      "productTaxonomy": {
        "taxonomyCategories": [
          {
            "category": "GCP"
          },
          {
            "category": "Compute"
          },
          {
            "category": "GCE"
          },
          {
            "category": "VMs On Demand"
          },
          {
            "category": "Memory: Per GB"
          },
          {
            "category": "C3"
          }
        ]
      },
      "geoTaxonomy": {
        "type": "REGIONAL",
        "regionalMetadata": {
          "region": {
            "region": "europe-west12"
          }
        }
      }
    }
  ],
  "nextPageToken": "alphanumeric-nextpageToken"
}

取得所有公開 Google Cloud SKU 的價格

使用任何要求資料之前，請先替換以下項目：

SKU_ID：要取得價格的特定 SKU ID。如要取得所有 SKU 的價格，請使用 `-`。
API_KEY：您的 Google Cloud API 金鑰。
PAGE_SIZE (選用)：要傳回的服務數量。預設值為 50。
PAGE_TOKEN (選用)：頁面權杖，可從先前回應的 nextPageToken 取得。

HTTP 方法和網址：

GET https://cloudbilling.googleapis.com/v1beta/skus/SKU_ID/prices?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN

如要傳送要求，請選擇以下其中一個選項：

curl

執行下列指令：

curl -X GET \
     "https://cloudbilling.googleapis.com/v1beta/skus/SKU_ID/prices?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN"

PowerShell

執行下列指令：

$headers = @{  }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://cloudbilling.googleapis.com/v1beta/skus/SKU_ID/prices?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN" | Select-Object -Expand Content

回應會包含每個 SKU ID 的價格資訊。以下範例顯示所有公開 SKU 的格式，頁面大小為 `2`。

結果會分頁顯示，每頁預設包含 50 個價格。回應包含 nextPageToken，可用於取得下一頁結果。如要擷取下一批結果，請設定 pageToken=PAGE_TOKEN。如要減少每頁的結果數，請設定 pageSize=PAGE_SIZE。列出所有項目後，系統不會傳回任何權杖。

{
  "prices": [
    {
      "name": "skus/0000-9B70-F099/price",
      "currencyCode": "USD",
      "valueType": "rate",
      "rate": {
        "tiers": [
          {
            "startAmount": {
              "value": "0"
            },
            "listPrice": {
              "currencyCode": "USD",
              "nanos": 690000000
            }
          }
        ],
        "unitInfo": {
          "unit": "h",
          "unitDescription": "hour",
          "unitQuantity": {
            "value": "1"
          }
        },
        "aggregationInfo": {
          "level": "LEVEL_ACCOUNT",
          "interval": "INTERVAL_MONTHLY"
        }
      }
    },
    {
      "name": "skus/0002-17F9-0731/price",
      "currencyCode": "USD",
      "valueType": "rate",
      "rate": {
        "tiers": [
          {
            "startAmount": {
              "value": "0"
            },
            "listPrice": {
              "currencyCode": "USD"
            }
          },
          {
            "startAmount": {
              "value": "1"
            },
            "listPrice": {
              "currencyCode": "USD",
              "nanos": 390000000
            }
          },
          {
            "startAmount": {
              "value": "1024"
            },
            "listPrice": {
              "currencyCode": "USD",
              "nanos": 340000000
            }
          }
        ],
        "unitInfo": {
          "unit": "GiBy.mo",
          "unitDescription": "gibibyte month",
          "unitQuantity": {
            "value": "1"
          }
        },
        "aggregationInfo": {
          "level": "LEVEL_ACCOUNT",
          "interval": "INTERVAL_MONTHLY"
        }
      }
    }
  ],
  "nextPageToken": "1234alphanumericCode"
}

取得公開 SKU 的價格

以下範例會取得公開列出的 SKU 價格。您可以在「SKU」頁面取得完整的 SKU ID 清單 Google Cloud 。

您不需要任何特定的 IAM 權限，即可發出這項 API 呼叫。

使用任何要求資料之前，請先替換以下項目：

API_KEY：您的 Google Cloud API 金鑰。
SKU_ID：SKU ID，可使用 skus.list 方法取得。ID 是 skus/ 識別碼後方的字串。
CURRENCY：(選填) 價格的 ISO-4217 貨幣代碼。如未指定，價格會以 Cloud Billing 帳戶的幣別顯示。

HTTP 方法和網址：

GET https://cloudbilling.googleapis.com/v1beta/skus/SKU_ID/price?key=API_KEY¤cyCode=CURRENCY

如要傳送要求，請選擇以下其中一個選項：

curl

執行下列指令：

curl -X GET \
     "https://cloudbilling.googleapis.com/v1beta/skus/SKU_ID/price?key=API_KEY¤cyCode=CURRENCY"

PowerShell

執行下列指令：

$headers = @{  }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://cloudbilling.googleapis.com/v1beta/skus/SKU_ID/price?key=API_KEY¤cyCode=CURRENCY" | Select-Object -Expand Content

以下範例顯示 SKU ID 0012-B7F2-DD14 的定價詳細資料。

{
  "name": "skus/0012-B7F2-DD14/price",
  "currencyCode": "USD",
  "valueType": "rate",
  "rate": {
    "tiers": [
      {
        "startAmount": {
          "value": "0"
        },
        "listPrice": {
          "currencyCode": "USD",
          "nanos": 1397000
        }
      }
    ],
    "unitInfo": {
      "unit": "GiBy.h",
      "unitDescription": "gibibyte hour",
      "unitQuantity": {
        "value": "1"
      }
    },
    "aggregationInfo": {
      "level": "ACCOUNT",
      "interval": "MONTHLY"
    }
  }
}

取得 Cloud Billing 帳戶專屬資訊

下列範例顯示 API 呼叫，可取得 Cloud Billing 帳戶專屬資訊，例如特定 SKU，或可能屬於自訂價格合約的價格資訊。

視您使用的 API 資源而定，您必須具備 Cloud Billing 帳戶的下列權限：

如要使用 billingAccounts.services 取得服務相關資訊，請先完成下列步驟：
- billing.billingAccountServices.get
- billing.billingAccountServices.list
如要使用 billingAccounts.skus 取得 SKU 相關資訊，請準備下列項目：
- billing.billingAccountSkus.get
- billing.billingAccountSkus.list
如要使用 billingAccounts.skugroups 取得 SKU 群組的相關資訊，請完成下列步驟：
- billing.billingAccountSkuGroups.get
- billing.billingAccountSkuGroups.list
如要使用 billingAccounts.skugroups.skus 取得 SKU 群組中的 SKU 相關資訊，請完成下列步驟：
- billing.billingAccountSkuGroupSkus.get
- billing.billingAccountSkuGroupSkus.list
如要使用 billingAccounts.skus.price 取得 SKU 價格資訊，請準備下列項目：
- billing.billingAccountPrice.get

如果您使用服務帳戶呼叫 API，服務帳戶必須具備相關權限。

下列預先定義的角色具有權限，可取得 Cloud Billing 帳戶的專屬資訊：

帳單帳戶管理員
帳單帳戶檢視者

取得 Cloud Billing 帳戶的 SKU 群組清單

如果您與 Google Cloud簽訂價格合約，合約可能會提及SKU 群組，其中包含屬於特定類別的 SKU。舉例來說，BigQuery SKU 群組包含各種位置的 BigQuery 分析和儲存空間 SKU。

以下範例列出 Cloud Billing 帳戶可用的 SKU 群組。

如要呼叫這個 API，您必須具備 Cloud Billing 帳戶的 billing.billingAccountSkuGroups.list IAM 權限。

使用任何要求資料之前，請先替換以下項目：

BILLING_ACCOUNT_ID：您的 Cloud Billing 帳戶 ID。
PAGE_SIZE (選用)：要傳回的 SKU 群組數量上限。預設值為 50，上限為 5000。
PAGE_TOKEN (選用)：頁面符記，位於回應的 nextPageToken 中。

HTTP 方法和網址：

GET https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skuGroups?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN

如要傳送要求，請選擇以下其中一個選項：

curl

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skuGroups?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN"

PowerShell

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skuGroups?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN" | Select-Object -Expand Content

回應會以清單形式列出 SKU 群組，格式如下所示。

結果會分頁顯示，每頁最多 50 個 SKU 群組。回應包含 nextPageToken，可用於取得下一頁結果。如要擷取下一批結果，請設定 pageToken=PAGE_TOKEN。如要減少每頁的 SKU 數量，請設定 pageSize=PAGE_SIZE。列出所有項目後，系統不會傳回任何權杖。

{
    "billingAccountSkuGroups": [
      {
        "name": "billingAccounts/012345-567890-ABCDEF/skuGroups/001234-group-id-1",
        "displayName": "SKU group name 1"
      },
      {
        "name": "billingAccounts/012345-567890-ABCDEF/skuGroups/0045657-group-id-2",
        "displayName": "SKU group name 2"
      },
      ...
      "nextPageToken": "A1234-alphanumeric-page-token"
}

取得 Cloud Billing 帳戶的 SKU 群組中的 SKU 清單

以下範例列出 SKU 群組中的 SKU，這些 SKU 可能屬於您的自訂價格合約。

如要呼叫這個 API，您必須具備 Cloud Billing 帳戶的 billing.billingAccountSkuGroupSkus.list IAM 權限。

使用任何要求資料之前，請先替換以下項目：

SKU_GROUP_ID：SKU 群組 ID，可從 billingAccount.skuGroups.list method 取得。
BILLING_ACCOUNT_ID：您的 Cloud Billing 帳戶 ID。
PAGE_SIZE (選用)：要取得的 SKU 群組數量。預設值為 5000。
PAGE_TOKEN (選用)：頁面符記，位於回應的 nextPageToken 中。

HTTP 方法和網址：

GET https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skuGroups/SKU_GROUP_ID/skus?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN

如要傳送要求，請選擇以下其中一個選項：

curl

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skuGroups/SKU_GROUP_ID/skus?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN"

PowerShell

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skuGroups/SKU_GROUP_ID/skus?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN" | Select-Object -Expand Content

以下範例顯示 Network Data Transfer SKU 群組的前 2 個 SKU，ID 為 28934b47-792e-4afa-a025-7720d410482f。

結果會分頁顯示，每頁最多 5000 個 SKU 群組。回應包含 nextPageToken，可用於取得下一頁結果。如要擷取下一批結果，請設定 pageToken=PAGE_TOKEN。如要減少每頁的 SKU 數量，請設定 pageSize=PAGE_SIZE。列出所有項目後，系統不會傳回任何權杖。

{
  "billingAccountSkuGroupSkus": [
    {
      "name": "billingAccounts/12345-ABCDE-EXAMPLE/skuGroups/28934b47-792e-4afa-a025-7720d410482f/skus/0009-6F35-3126",
      "skuId": "0009-6F35-3126",
      "displayName": "Network Internet Data Transfer from EMEA to Seoul",
      "service": "9662-B51E-5089",
      "productTaxonomy": {
        "taxonomyCategories": [
          {
            "category": "GCP"
          },
          {
            "category": "Network"
          },
          {
            "category": "Data Transfer"
          },
          {
            "category": "Cloud SQL"
          },
          {
            "category": "Premium"
          }
        ]
      },
      "geoTaxonomy": {
        "type": "REGIONAL",
        "regionalMetadata": {
          "region": {
            "region": "europe-west1"
          }
        }
      }
    },
    {
      "name": "billingAccounts/12345-ABCDE-EXAMPLE/skuGroups/28934b47-792e-4afa-a025-7720d410482f/skus/000B-47CC-2924",
      "skuId": "000B-47CC-2924",
      "displayName": "API Gateway Network Internet Data Transfer Intercontinental from/to Oceania",
      "service": "36A9-155B-23F0",
      "productTaxonomy": {
        "taxonomyCategories": [
          {
            "category": "GCP"
          },
          {
            "category": "Network"
          },
          {
            "category": "Data Transfer"
          },
          {
            "category": "API Gateway"
          },
          {
            "category": "Premium"
          }
        ]
      },
      "geoTaxonomy": {}
    }
  ],
  "nextPageToken": "alphanumeric-nextPageToken"
}

取得 Cloud Billing 帳戶所有 Google Cloud SKU 的價格

使用任何要求資料之前，請先替換以下項目：

SKU_ID：要取得價格的特定 SKU ID。如要取得所有 SKU 的價格，請使用 `-`。
API_KEY：您的 Google Cloud API 金鑰。
PAGE_SIZE (選用)：要傳回的服務數量。預設值為 50。
PAGE_TOKEN (選用)：頁面權杖，可從先前回應的 nextPageToken 取得。

HTTP 方法和網址：

GET https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skus/SKU_ID/prices?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN

如要傳送要求，請選擇以下其中一個選項：

curl

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skus/SKU_ID/prices?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN"

PowerShell

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skus/SKU_ID/prices?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN" | Select-Object -Expand Content

回應會列出 SKU ID 和價格，包括僅適用於 Cloud Billing 帳戶的 SKU，以及每個 SKU 的價格資訊。以下範例顯示所有 SKU 的格式，頁面大小為 `2`。

結果會分頁顯示，每頁預設包含 50 個價格。回應包含 nextPageToken，可用於取得下一頁結果。如要擷取下一批結果，請設定 pageToken=PAGE_TOKEN。如要變更每頁的結果數，請設定 pageSize=PAGE_SIZE。列出所有項目後，系統不會傳回任何權杖。

{
  "billingAccountPrices": [
    {
      "name": "billingAccounts/01ABCD-EFGH23-UVWXYZ/skus/0000-9B70-F099/price",
      "currencyCode": "USD",
      "valueType": "rate",
      "rate": {
        "tiers": [
          {
            "startAmount": {
              "value": "0"
            },
            "listPrice": {
              "currencyCode": "USD",
              "nanos": 690000000
            },
            "contractPrice": {
              "currencyCode": "USD",
              "nanos": 690000000
            },
            "effectiveDiscountPercent": {
              "value": "0"
            }
          }
        ],
        "unitInfo": {
          "unit": "h",
          "unitDescription": "hour",
          "unitQuantity": {
            "value": "1"
          }
        },
        "aggregationInfo": {
          "level": "LEVEL_ACCOUNT",
          "interval": "INTERVAL_MONTHLY"
        }
      },
      "priceReason": {
        "type": "default-price",
        "defaultPrice": {}
      }
    },
    {
      "name": "billingAccounts/01ABCD-EFGH23-UVWXYZ/skus/0002-17F9-0731/price",
      "currencyCode": "USD",
      "valueType": "rate",
      "rate": {
        "tiers": [
          {
            "startAmount": {
              "value": "0"
            },
            "listPrice": {
              "currencyCode": "USD"
            },
            "contractPrice": {
              "currencyCode": "USD"
            },
            "effectiveDiscountPercent": {
              "value": "0"
            }
          },
          {
            "startAmount": {
              "value": "1"
            },
            "listPrice": {
              "currencyCode": "USD",
              "nanos": 390000000
            },
            "contractPrice": {
              "currencyCode": "USD",
              "nanos": 390000000
            },
            "effectiveDiscountPercent": {
              "value": "0"
            }
          },
          {
            "startAmount": {
              "value": "1024"
            },
            "listPrice": {
              "currencyCode": "USD",
              "nanos": 340000000
            },
            "contractPrice": {
              "currencyCode": "USD",
              "nanos": 340000000
            },
            "effectiveDiscountPercent": {
              "value": "0"
            }
          }
        ],
        "unitInfo": {
          "unit": "GiBy.mo",
          "unitDescription": "gibibyte month",
          "unitQuantity": {
            "value": "1"
          }
        },
        "aggregationInfo": {
          "level": "LEVEL_ACCOUNT",
          "interval": "INTERVAL_MONTHLY"
        }
      },
      "priceReason": {
        "type": "default-price",
        "defaultPrice": {}
      }
    }
  ],
  "nextPageToken": "1234alphanumericCode"
}

取得 Cloud Billing 帳戶的 SKU 價格

以下範例會取得您為 SKU 支付的價格。如果 SKU 屬於自訂價格合約，回應會包含定價折扣資訊。

如要呼叫這個 API，您必須具備 Cloud Billing 帳戶的 billing.billingAccountPrice.get IAM 權限。

使用任何要求資料之前，請先替換以下項目：

SKU_ID：SKU ID，可使用 billingAccounts.skus 方法取得。ID 是 skus/ 識別碼後方的字串。
BILLING_ACCOUNT_ID：您的 Cloud Billing 帳戶 ID。
CURRENCY：(選填) 價格的 ISO-4217 貨幣代碼。如未指定，價格會以 Cloud Billing 帳戶的幣別顯示。

HTTP 方法和網址：

GET https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skus/SKU_ID/price?currencyCode=CURRENCY

如要傳送要求，請選擇以下其中一個選項：

curl

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skus/SKU_ID/price?currencyCode=CURRENCY"

PowerShell

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skus/SKU_ID/price?currencyCode=CURRENCY" | Select-Object -Expand Content

回應會包含 priceReason 物件，其中詳列 SKU 的收費方式。以下範例顯示 SKU ID 0012-B7F2-DD14 的定價詳細資料。在本例中，Cloud Billing 帳戶有價格合約，但支付的是這個 SKU 的定價。

{
  "name": "billingAccounts/015978-D9414D-B80267/skus/0012-B7F2-DD14/price",
  "currencyCode": "USD",
  "valueType": "rate",
  "rate": {
    "tiers": [
      {
        "startAmount": {
          "value": "0"
        },
        "listPrice": {
          "currencyCode": "USD",
          "nanos": 1270000
        },
        "contractPrice": {
          "currencyCode": "USD",
          "nanos": 1270000
        }
      }
    ],
    "unitInfo": {
      "unit": "GiBy.h",
      "unitDescription": "gibibyte hour",
      "unitQuantity": {
        "value": "1"
      }
    },
    "aggregationInfo": {
      "level": "ACCOUNT",
      "interval": "MONTHLY"
    }
  },
  "priceReason": {
    "type": "default-price",
    "defaultPrice": {}
  }
}

取得 Google Cloud 定價資訊 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

事前準備

取得公開服務和定價資訊

取得公開 Google Cloud 服務清單

curl

PowerShell

取得公用 Google Cloud 服務的 SKU 清單

curl

PowerShell

取得所有公開 Google Cloud SKU 的價格

curl

PowerShell

取得公開 SKU 的價格

curl

PowerShell

取得 Cloud Billing 帳戶專屬資訊

取得 Cloud Billing 帳戶的 SKU 群組清單

curl

PowerShell

取得 Cloud Billing 帳戶的 SKU 群組中的 SKU 清單

curl

PowerShell

取得 Cloud Billing 帳戶所有 Google Cloud SKU 的價格

curl

PowerShell

取得 Cloud Billing 帳戶的 SKU 價格

curl

PowerShell

相關主題

取得 Google Cloud 定價資訊