Receber informações de preços do Google Cloud

A API Google Cloud Pricing é um conjunto de recursos de API que ajuda você a conseguir os preços e outras informações dos serviços do Google Cloud.

Nesta página, você encontrará alguns exemplos de solicitações de API que podem ser feitas para receber informações sobre serviços e SKUs listados publicamente, além de serviços e SKUs disponíveis apenas para a conta do Cloud Billing como parte de um contrato com o Google Cloud.

Use a API Pricing para acessar uma lista de serviços ou o preço de uma unidade de manutenção de estoque (SKU) específica. Uma SKU identifica claramente um recurso que você pode comprar. Um exemplo de SKU é Nvidia Tesla T4 GPU attached to Spot Preemptible VMs running in Warsaw. Se você tiver um contrato de preços personalizados, também poderá usar a API Pricing para receber os preços personalizados associados à sua conta do Cloud Billing.

Para uma lista completa de recursos disponíveis na API Pricing e informações detalhadas sobre os formatos de solicitação e resposta, consulte a referência da API.

Antes de começar

Enable the Cloud Billing API.

Enable the API

Receber informações sobre preços e serviços públicos

Os exemplos a seguir mostram chamadas de API que podem ser usadas para receber informações listadas publicamente sobre os serviços e as SKUs do Google Cloud.

Para informações sobre serviços públicos, SKUs ou preços, crie uma chave de API.

Receber uma lista de serviços públicos do Google Cloud

O exemplo a seguir lista todos os serviços públicos do Google Cloud, incluindo os metadados de cada serviço.

Você não precisa de permissões específicas do IAM para fazer essa chamada de API.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • API_KEY: sua chave de API do Google Cloud.
  • PAGE_SIZE (opcional): o número de serviços a serem retornados. O padrão é 50.
  • PAGE_TOKEN (opcional): o token da página, que você recebe de nextPageToken em uma resposta anterior.

Método HTTP e URL:

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

Para enviar a solicitação, escolha uma destas opções:

curl

Execute o seguinte comando:

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

PowerShell

execute o seguinte comando:

$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

A resposta contém uma lista de serviços e informações sobre cada serviço. O exemplo abaixo mostra o formato do Compute Engine.

Os resultados são paginados e limitados a 50 serviços por página. A resposta inclui um nextPageToken que pode ser usado para conseguir a próxima página de resultados. Para buscar o próximo lote, defina pageToken=PAGE_TOKEN. Para reduzir o número de SKUs por página, defina pageSize=PAGE_SIZE. Quando todos os itens forem listados, nenhum token será retornado.

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

Receber uma lista de SKUs de um serviço público do Google Cloud

O exemplo a seguir lista as SKUs públicas de um serviço especificado.

Você não precisa de permissões específicas do IAM para fazer essa chamada de API.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • API_KEY: sua chave de API do Google Cloud.
  • FILTER: os serviços para filtrar as SKUs. Por exemplo, para listar SKUs do Compute Engine, use o filtro service="services/6F81-5844-456A".
  • PAGE_SIZE (opcional): o número máximo de SKUs a serem retornadas. O padrão é 50, e o máximo é 5.000.
  • PAGE_TOKEN (opcional): o token da página, que está em nextPageToken na resposta.

Método HTTP e URL:

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

Para enviar a solicitação, escolha uma destas opções:

curl

Execute o seguinte comando:

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

PowerShell

execute o seguinte comando:

$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
A resposta a seguir mostra alguns exemplos de SKUs retornados para o Compute Engine. Os resultados são paginados e limitados a 50 SKUs por página. A resposta inclui um nextPageToken que pode ser usado para conseguir a próxima página de resultados. Para buscar o próximo lote, defina pageToken=PAGE_TOKEN. Para alterar o número de SKUs por página, defina pageSize=PAGE_SIZE. Quando todos os itens forem listados, nenhum token será retornado.
{
  "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"
}

Consultar os preços de todas as SKUs públicas do Google Cloud

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • SKU_ID: um ID de SKU específico para receber o preço. Para acessar os preços de todas as SKUs, use "-".
  • API_KEY: sua chave de API do Google Cloud.
  • PAGE_SIZE (opcional): o número de serviços a serem retornados. O padrão é 50.
  • PAGE_TOKEN (opcional): o token da página, que você recebe de nextPageToken em uma resposta anterior.

Método HTTP e URL:

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

Para enviar a solicitação, escolha uma destas opções:

curl

Execute o seguinte comando:

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

PowerShell

execute o seguinte comando:

$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

A resposta contém informações sobre o preço de cada ID de SKU. O exemplo abaixo mostra o formato de todas as SKUs públicas, com tamanho de página "2".

Os resultados são paginados e, por padrão, contêm 50 preços por página. A resposta inclui um nextPageToken que pode ser usado para conseguir a próxima página de resultados. Para buscar o próximo lote, defina pageToken=PAGE_TOKEN. Para reduzir o número de resultados por página, defina pageSize=PAGE_SIZE. Quando todos os itens forem listados, nenhum token será retornado.

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

Conferir o preço de uma SKU pública

O exemplo a seguir mostra o preço de uma SKU listada publicamente. Confira uma lista completa dos IDs de SKU do Google Cloud na página "SKUs".

Você não precisa de permissões específicas do IAM para fazer essa chamada de API.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • API_KEY: sua chave de API do Google Cloud.
  • SKU_ID: o identificador da SKU, que pode ser conseguido usando o método skus.list. O ID é a string após o identificador skus/.
  • CURRENCY (opcional): o código de moeda ISO-4217 para o preço. Se não for especificado, o preço estará na mesma moeda da sua conta do Cloud Billing.

Método HTTP e URL:

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

Para enviar a solicitação, escolha uma destas opções:

curl

Execute o seguinte comando:

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

PowerShell

execute o seguinte comando:

$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
O exemplo a seguir mostra os detalhes dos preços do ID da 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"
    }
  }
}

Receber informações específicas da sua conta do Cloud Billing

Os exemplos a seguir mostram chamadas de API que recebem informações específicas da sua conta do Cloud Billing, como SKUs específicas ou informações sobre preços que podem fazer parte do seu contrato de preços personalizado.

Dependendo do recurso de API usado, você precisará ter estas permissões na conta do Cloud Billing:

  • Para receber informações sobre serviços usando billingAccounts.services, você precisa de:

    • billing.billingAccountServices.get
    • billing.billingAccountServices.list
  • Para receber informações sobre SKUs usando billingAccounts.skus, é necessário:

    • billing.billingAccountSkus.get
    • billing.billingAccountSkus.list
  • Para receber informações sobre grupos de SKUs usando billingAccounts.skugroups, é necessário:

    • billing.billingAccountSkuGroups.get
    • billing.billingAccountSkuGroups.list
  • Para receber informações sobre SKUs que fazem parte de grupos de SKUs usando billingAccounts.skugroups.skus, é necessário:

    • billing.billingAccountSkuGroupSkus.get
    • billing.billingAccountSkuGroupSkus.list
  • Para receber informações sobre preços de SKUs usando billingAccounts.skus.price, é necessário:

    • billing.billingAccountPrice.get

Se você estiver chamando a API usando uma conta de serviço, ela precisará ter as permissões.

Os papéis predefinidos a seguir têm permissões para receber informações específicas da sua conta do Cloud Billing:

  • Administrador da conta de faturamento
  • Leitor da conta de faturamento

Conferir uma lista de grupos de SKUs da sua conta do Cloud Billing

Se você tiver um contrato de preços com o Google Cloud, ele poderá se referir aos grupos de SKUs, que contêm SKUs que se enquadram em uma categoria específica. Por exemplo, o grupo de SKUs do BigQuery contém SKUs para análise e armazenamento em vários locais.

No exemplo a seguir, listamos os grupos de SKUs disponíveis para sua conta do Cloud Billing.

Para fazer essa chamada de API, você precisa da permissão billing.billingAccountSkuGroups.list do IAM na sua conta do Cloud Billing.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • BILLING_ACCOUNT_ID: o ID da conta do Cloud Billing.
  • PAGE_SIZE (opcional): o número máximo de grupos de SKUs a serem retornados. O padrão é 50, e o máximo é 5.000.
  • PAGE_TOKEN (opcional): o token da página, que está em nextPageToken na resposta.

Método HTTP e URL:

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

Para enviar a solicitação, escolha uma destas opções:

curl

Execute o seguinte comando:

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

execute o seguinte comando:

$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

A resposta é uma lista de grupos de SKUs no formato mostrado abaixo.

Os resultados são paginados e limitados a 50 grupos de SKUs por página. A resposta inclui um nextPageToken que pode ser usado para conseguir a próxima página de resultados. Para buscar o próximo lote, defina pageToken=PAGE_TOKEN. Para reduzir o número de SKUs por página, defina pageSize=PAGE_SIZE. Quando todos os itens forem listados, nenhum token será retornado.

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

Receber uma lista de SKUs em um grupo de SKUs para sua conta do Cloud Billing

No exemplo a seguir, listamos as SKUs em um grupo que podem fazer parte do seu contrato de preços personalizado.

Para fazer essa chamada de API, você precisa da permissão billing.billingAccountSkuGroupSkus.list do IAM na sua conta do Cloud Billing.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • SKU_GROUP_ID: o ID do grupo SKU, que você recebe do billingAccount.skuGroups.list method.
  • BILLING_ACCOUNT_ID: o ID da conta do Cloud Billing.
  • PAGE_SIZE (opcional): o número de grupos de SKUs a serem recebidas. O padrão é 5.000.
  • PAGE_TOKEN (opcional): o token da página, que está em nextPageToken na resposta.

Método HTTP e URL:

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

Para enviar a solicitação, escolha uma destas opções:

curl

Execute o seguinte comando:

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

execute o seguinte comando:

$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

O exemplo a seguir mostra as duas primeiras SKUs do grupo de SKUs Network Data Transfer, com o ID 28934b47-792e-4afa-a025-7720d410482f.

Os resultados são paginados e limitados a 5.000 grupos de SKUs por página. A resposta inclui um nextPageToken que pode ser usado para conseguir a próxima página de resultados. Para buscar o próximo lote, defina pageToken=PAGE_TOKEN. Para reduzir o número de SKUs por página, defina pageSize=PAGE_SIZE. Quando todos os itens forem listados, nenhum token será retornado.

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

Conferir os preços de todas as SKUs do Google Cloud na sua conta do Cloud Billing

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • SKU_ID: um ID de SKU específico para receber o preço. Para acessar os preços de todas as SKUs, use "-".
  • API_KEY: sua chave de API do Google Cloud.
  • PAGE_SIZE (opcional): o número de serviços a serem retornados. O padrão é 50.
  • PAGE_TOKEN (opcional): o token da página, que você recebe de nextPageToken em uma resposta anterior.

Método HTTP e URL:

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

Para enviar a solicitação, escolha uma destas opções:

curl

Execute o seguinte comando:

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

execute o seguinte comando:

$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

A resposta contém uma lista de IDs de SKU e os preços deles, incluindo SKUs que estão disponíveis apenas para sua conta do Cloud Billing e informações sobre preços para cada SKU. O exemplo abaixo mostra o formato de todas as SKUs, com tamanho de página 2.

Os resultados são paginados e, por padrão, contêm 50 preços por página. A resposta inclui um nextPageToken que pode ser usado para conseguir a próxima página de resultados. Para buscar o próximo lote, defina pageToken=PAGE_TOKEN. Para alterar o número de resultados por página, defina pageSize=PAGE_SIZE. Quando todos os itens forem listados, nenhum token será retornado.

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

Conferir os preços das SKUs da sua conta do Cloud Billing

O exemplo a seguir mostra o preço que você está pagando por uma SKU. Se a SKU fizer parte de um contrato de preços personalizados, a resposta incluirá informações sobre o desconto no preço de tabela.

Para fazer essa chamada de API, você precisa da permissão billing.billingAccountPrice.get do IAM na sua conta do Cloud Billing.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • SKU_ID: o identificador da SKU, que pode ser conseguido usando o método billingAccounts.skus. O ID é a string após o identificador skus/.
  • BILLING_ACCOUNT_ID: o ID da conta do Cloud Billing.
  • CURRENCY (opcional): o código de moeda ISO-4217 para o preço. Se não for especificado, o preço estará na mesma moeda da sua conta do Cloud Billing.

Método HTTP e URL:

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

Para enviar a solicitação, escolha uma destas opções:

curl

Execute o seguinte comando:

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

execute o seguinte comando:

$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
A resposta contém detalhes sobre como a SKU é cobrada no objeto priceReason. O exemplo a seguir mostra os detalhes dos preços do ID da SKU 0012-B7F2-DD14. Neste exemplo, a conta do Cloud Billing tem um contrato de preços, mas está pagando o preço de tabela da 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": {}
  }
}