Mendapatkan informasi harga Google Cloud

Google Cloud Pricing API adalah kumpulan resource API yang membantu Anda mendapatkan harga dan informasi lain untuk layanan Google Cloud.

Halaman ini menunjukkan beberapa contoh permintaan API yang dapat Anda buat untuk mendapatkan informasi layanan dan SKU yang tercantum secara publik, serta layanan dan SKU yang hanya tersedia untuk akun Penagihan Cloud Anda sebagai bagian dari kontrak dengan Google Cloud.

Anda dapat menggunakan Pricing API untuk mendapatkan daftar layanan, atau harga unit penyimpanan persediaan (SKU) tertentu. SKU akan mengidentifikasi secara jelas resource yang dapat Anda beli. Contoh SKU adalah Nvidia Tesla T4 GPU attached to Spot Preemptible VMs running in Warsaw. Jika memiliki kontrak dengan harga kustom, Anda juga dapat menggunakan Pricing API untuk mendapatkan harga khusus yang terkait dengan akun Penagihan Cloud Anda.

Untuk mengetahui daftar lengkap resource yang tersedia dalam Pricing API, serta informasi format permintaan dan respons yang mendetail, lihat referensi API.

Sebelum memulai

Aktifkan API Cloud Billing.

Mengaktifkan API

API diaktifkan di project Google Cloud. Pricing API adalah bagian dari Cloud Billing API. Saat diminta untuk mengonfirmasi project yang ingin Anda gunakan untuk Pricing API, sebaiknya gunakan project Google Cloud yang disiapkan untuk menampung semua kebutuhan FinOps dan administrasi penagihan untuk akun Penagihan Cloud. Project ini dapat berisi semua API khusus penagihan, termasuk Cloud Billing API.

Pelajari lebih lanjut manfaat menggunakan project yang berfokus pada FinOps untuk kasus penggunaan administrasi penagihan Anda.

Mendapatkan informasi layanan publik dan harga

Contoh berikut menunjukkan panggilan API yang dapat Anda gunakan untuk mendapatkan informasi SKU dan layanan Google Cloud yang tercantum secara publik.

Untuk mendapatkan informasi layanan publik, SKU, atau harga, Anda harus membuat kunci API.

Mendapatkan daftar layanan Google Cloud publik

Contoh berikut mencantumkan semua layanan Google Cloud publik, termasuk metadata untuk setiap layanan.

Anda tidak memerlukan izin IAM tertentu untuk melakukan panggilan API ini.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • API_KEY: Kunci Google Cloud API.
  • PAGE_SIZE (Opsional): Jumlah layanan yang akan ditampilkan. Jumlah default-nya adalah 50.
  • PAGE_TOKEN (Opsional): Token halaman, yang Anda dapatkan dari nextPageToken dalam respons sebelumnya.

Metode HTTP dan URL: 

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

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Jalankan perintah berikut: 

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

PowerShell

Jalankan perintah berikut: 

$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

Respons berisi daftar layanan, dan informasi setiap layanan. Contoh di bawah ini menunjukkan format untuk Compute Engine.

Hasil akan diberi nomor halaman dan dibatasi hingga 50 layanan per halaman. Respons berisi nextPageToken yang dapat Anda gunakan untuk mendapatkan halaman hasil berikutnya. Untuk mengambil batch berikutnya, tetapkan pageToken=PAGE_TOKEN. Untuk mengurangi jumlah SKU per halaman, tetapkan pageSize=PAGE_SIZE. Setelah semua item tercantum, tidak akan ada token yang ditampilkan. 

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

Mendapatkan daftar SKU untuk layanan Google Cloud publik

Contoh berikut mencantumkan SKU publik untuk layanan tertentu.

Anda tidak memerlukan izin IAM tertentu untuk melakukan panggilan API ini.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • API_KEY: Kunci Google Cloud API.
  • FILTER: Layanan untuk memfilter SKU. Misalnya, jika ingin mencantumkan SKU untuk Compute Engine, gunakan filter service="services/6F81-5844-456A".
  • PAGE_SIZE (Opsional): Jumlah maksimum SKU untuk ditampilkan. Jumlah default-nya adalah 50, dan maksimum 5.000.
  • PAGE_TOKEN (Opsional): Token halaman, yang ada di nextPageToken dalam respons.

Metode HTTP dan URL: 

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

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Jalankan perintah berikut: 

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

PowerShell

Jalankan perintah berikut: 

$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
Respons berikut menunjukkan beberapa contoh SKU yang ditampilkan untuk Compute Engine. Hasil akan diberi nomor halamani dan dibatasi hingga 50 SKU per halaman. Respons berisi nextPageToken yang dapat Anda gunakan untuk mendapatkan halaman hasil berikutnya. Untuk mengambil batch berikutnya, tetapkan pageToken=PAGE_TOKEN. Untuk mengubah jumlah SKU per halaman, tetapkan pageSize=PAGE_SIZE. Setelah semua item tercantum, tidak akan ada token yang ditampilkan. 
{
  "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"
}

Mendapatkan harga untuk semua SKU Google Cloud publik

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • SKU_ID: ID SKU tertentu untuk mendapatkan harganya. Untuk mendapatkan harga semua SKU, gunakan `-`.
  • API_KEY: Kunci Google Cloud API.
  • PAGE_SIZE (Opsional): Jumlah layanan yang akan ditampilkan. Jumlah default-nya adalah 50.
  • PAGE_TOKEN (Opsional): Token halaman, yang Anda dapatkan dari nextPageToken dalam respons sebelumnya.

Metode HTTP dan URL: 

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

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Jalankan perintah berikut: 

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

PowerShell

Jalankan perintah berikut: 

$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

Respons berisi informasi harga untuk setiap ID SKU.Contoh di bawah menunjukkan format untuk semua SKU publik, dengan ukuran halaman `2`.

Hasil akan diberi nomor halaman dan secara default berisi 50 harga per halaman. Respons berisi nextPageToken yang dapat Anda gunakan untuk mendapatkan halaman hasil berikutnya. Untuk mengambil batch berikutnya, tetapkan pageToken=PAGE_TOKEN. Untuk mengurangi jumlah hasil per halaman, tetapkan pageSize=PAGE_SIZE. Setelah semua item tercantum, tidak akan ada token yang ditampilkan. 

{
  "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"
}

Mendapatkan harga SKU publik

Contoh berikut menampilkan cara mendapatkan harga SKU yang tercantum secara publik. Anda bisa mendapatkan daftar lengkap ID SKU Google Cloud di halaman SKU.

Anda tidak memerlukan izin IAM tertentu untuk melakukan panggilan API ini.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • API_KEY: Kunci Google Cloud API.
  • SKU_ID: ID SKU, yang bisa Anda dapatkan menggunakan metode skus.list. ID adalah string setelah ID skus/.
  • CURRENCY: (Opsional) Kode mata uang ISO-4217 untuk harga. Jika tidak ditentukan, harga akan menggunakan mata uang yang sama seperti yang ada digunakan di akun Penagihan Cloud Anda.

Metode HTTP dan URL: 

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

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Jalankan perintah berikut: 

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

PowerShell

Jalankan perintah berikut: 

$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
Contoh berikut menunjukkan detail harga untuk ID SKU 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"
    }
  }
}

Mendapatkan informasi khusus untuk akun Penagihan Cloud Anda

Contoh berikut menunjukkan panggilan API yang mendapatkan informasi khusus akun Penagihan Cloud Anda, seperti SKU tertentu atau informasi harga yang mungkin menjadi bagian dari kontrak harga kustom Anda.

Bergantung pada resource API yang digunakan, Anda harus memiliki izin berikut untuk akun Penagihan Cloud:

  • Untuk mendapatkan informasi layanan menggunakan billingAccounts.services, Anda memerlukan:

    • billing.billingAccountServices.get
    • billing.billingAccountServices.list

  • Untuk mendapatkan informasi SKU menggunakan billingAccounts.skus, Anda memerlukan:

    • billing.billingAccountSkus.get
    • billing.billingAccountSkus.list

  • Untuk mendapatkan informasi Grup SKU menggunakan billingAccounts.skugroups, Anda memerlukan:

    • billing.billingAccountSkuGroups.get
    • billing.billingAccountSkuGroups.list

  • Untuk mendapatkan informasi SKU yang menjadi bagian dari Grup SKU menggunakan billingAccounts.skugroups.skus, Anda memerlukan:

    • billing.billingAccountSkuGroupSkus.get
    • billing.billingAccountSkuGroupSkus.list

  • Untuk mendapatkan informasi harga SKU yang menggunakan billingAccounts.skus.price, Anda memerlukan:

    • billing.billingAccountPrice.get

Jika Anda memanggil API menggunakan akun layanan, akun layanan tersebut harus memiliki izin.

Peran yang telah ditetapkan berikut memiliki izin untuk mendapatkan informasi khusus terkait akun Penagihan Cloud Anda:

  • Billing Account Administrator
  • Billing Account Viewer

Mendapatkan daftar grup SKU untuk akun Penagihan Cloud Anda

Jika Anda memiliki kontrak harga dengan Google Cloud, kontrak Anda mungkin merujuk pada grup SKU, yang berisi SKU yang termasuk dalam kategori tertentu. Misalnya, grup SKU BigQuery berisi SKU untuk analisis dan penyimpanan BigQuery di berbagai lokasi.

Contoh berikut mencantumkan grup SKU yang tersedia untuk akun Penagihan Cloud Anda.

Untuk melakukan panggilan API ini, Anda memerlukan izin IAM billing.billingAccountSkuGroups.list di akun Penagihan Cloud Anda.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • BILLING_ACCOUNT_ID: ID akun Penagihan Cloud.
  • PAGE_SIZE (Opsional): Jumlah maksimum grup SKU untuk ditampilkan. Jumlah default-nya adalah 50, dan maksimum 5.000.
  • PAGE_TOKEN (Opsional): Token halaman, yang ada di nextPageToken dalam respons.

Metode HTTP dan URL: 

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

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Jalankan perintah berikut: 

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

Jalankan perintah berikut: 

$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

Respon adalah daftar grup SKU, dalam format yang ditunjukkan di bawah ini.

Hasil akan diberi nomor halaman dan dibatasi hingga 50 grup SKU per halaman. Respons berisi nextPageToken yang dapat Anda gunakan untuk mendapatkan halaman hasil berikutnya. Untuk mengambil batch berikutnya, tetapkan pageToken=PAGE_TOKEN. Untuk mengurangi jumlah SKU per halaman, tetapkan pageSize=PAGE_SIZE. Setelah semua item tercantum, tidak akan ada token yang ditampilkan. 

{
    "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"
}

Mendapatkan daftar SKU dalam grup SKU untuk akun Penagihan Cloud Anda

Contoh berikut mencantumkan SKU dalam grup SKU yang mungkin menjadi bagian dari kontrak harga kustom Anda.

Untuk melakukan panggilan API ini, Anda memerlukan izin IAM billing.billingAccountSkuGroupSkus.list di akun Penagihan Cloud Anda.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • SKU_GROUP_ID: ID grup SKU, yang Anda dapatkan dari billingAccount.skuGroups.list method.
  • BILLING_ACCOUNT_ID: ID akun Penagihan Cloud.
  • PAGE_SIZE (Opsional): Jumlah grup SKU yang akan didapatkan. Jumlah default-nya adalah 5.000.
  • PAGE_TOKEN (Opsional): Token halaman, yang ada di nextPageToken dalam respons.

Metode HTTP dan URL: 

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

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Jalankan perintah berikut: 

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

Jalankan perintah berikut: 

$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

Contoh berikut menampilkan 2 SKU pertama untuk grup SKU Network Data Transfer, dengan ID 28934b47-792e-4afa-a025-7720d410482f.

Hasil akan diberi nomor halaman dan dibatasi hingga 5.000 grup SKU per halaman. Respons berisi nextPageToken yang dapat Anda gunakan untuk mendapatkan halaman hasil berikutnya. Untuk mengambil batch berikutnya, tetapkan pageToken=PAGE_TOKEN. Untuk mengurangi jumlah SKU per halaman, tetapkan pageSize=PAGE_SIZE. Setelah semua item tercantum, tidak akan ada token yang ditampilkan. 

{
  "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"
}

Mendapatkan harga untuk semua SKU Google Cloud untuk akun Penagihan Cloud Anda

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • SKU_ID: ID SKU tertentu untuk mendapatkan harganya. Untuk mendapatkan harga semua SKU, gunakan `-`.
  • API_KEY: Kunci Google Cloud API.
  • PAGE_SIZE (Opsional): Jumlah layanan yang akan ditampilkan. Jumlah default-nya adalah 50.
  • PAGE_TOKEN (Opsional): Token halaman, yang Anda dapatkan dari nextPageToken dalam respons sebelumnya.

Metode HTTP dan URL: 

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

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Jalankan perintah berikut: 

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

Jalankan perintah berikut: 

$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

Respons berisi daftar ID SKU dan harganya, termasuk SKU yang hanya tersedia untuk akun Penagihan Cloud Anda, dan informasi harga untuk setiap SKU. Contoh di bawah ini menunjukkan format untuk semua SKU, dengan ukuran halaman `2`.

Hasil akan diberi nomor halaman dan secara default berisi 50 harga per halaman. Respons berisi nextPageToken yang dapat Anda gunakan untuk mendapatkan halaman hasil berikutnya. Untuk mengambil batch berikutnya, tetapkan pageToken=PAGE_TOKEN. Untuk mengubah jumlah hasil per halaman, tetapkan pageSize=PAGE_SIZE. Setelah semua item tercantum, tidak akan ada token yang ditampilkan. 

{
  "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"
}

Mendapatkan harga SKU untuk akun Penagihan Cloud Anda

Contoh berikut menampilkan harga yang Anda bayar untuk SKU. Jika SKU adalah bagian dari kontrak harga kustom, respons akan menyertakan informasi diskon harga jual.

Untuk melakukan panggilan API ini, Anda memerlukan izin IAM billing.billingAccountPrice.get di akun Penagihan Cloud Anda.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • SKU_ID: ID SKU, yang bisa Anda dapatkan menggunakan metode billingAccounts.skus. ID adalah string setelah ID skus/.
  • BILLING_ACCOUNT_ID: ID akun Penagihan Cloud.
  • CURRENCY: (Opsional) Kode mata uang ISO-4217 untuk harga. Jika tidak ditentukan, harga akan menggunakan mata uang yang sama seperti yang ada digunakan di akun Penagihan Cloud Anda.

Metode HTTP dan URL: 

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

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Jalankan perintah berikut: 

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

Jalankan perintah berikut: 

$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
Respons berisi detail hitungan penagihan SKU, dalam objek priceReason. Contoh berikut menunjukkan detail harga untuk ID SKU 0012-B7F2-DD14. Dalam contoh ini, akun Penagihan Cloud memiliki kontrak harga, tetapi membayar harga jual untuk SKU ini. 
{
  "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": {}
  }
}