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

A Google Cloud API Pricing é um conjunto de recursos de API que ajuda a obter os preços e outras informações sobre os Google Cloud serviços.

Esta página mostra alguns exemplos de pedidos de API que pode fazer para obter informações sobre serviços e SKUs listados publicamente, bem como serviços e SKUs que estão disponíveis apenas para a sua conta do Cloud Billing como parte de um contrato com a Google Cloud.

Pode usar a API Pricing para obter uma lista de serviços ou o preço de uma unidade de gestão de stock (SKU) específica. Um SKU identifica claramente um recurso que pode comprar. Um exemplo de SKU é Nvidia Tesla T4 GPU attached to Spot Preemptible VMs running in Warsaw. Se tiver um contrato com preços personalizados, também pode usar a API Pricing para obter os preços personalizados associados à sua conta de faturação do Google Cloud.

Para ver uma lista completa dos recursos disponíveis na API Pricing e para obter informações detalhadas sobre os formatos de pedido e resposta, consulte a referência da API.

Antes de começar

Enable the Cloud Billing API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

As APIs estão ativadas num Google Cloud projeto. A API Pricing faz parte da API Cloud Billing. Quando lhe for pedido que confirme o projeto que pretende usar para a API Pricing, recomendamos que use um Google Cloud projeto configurado para conter todas as suas necessidades de administração de faturação e FinOps para uma conta de faturação do Google Cloud. Este projeto pode conter todas as APIs específicas da faturação, incluindo a API Cloud Billing.

Saiba mais sobre as vantagens de usar um projeto focado em FinOps para os seus exemplos de utilização de administração de faturação.

Receba informações de preços e serviços públicos

Os exemplos seguintes mostram chamadas de API que pode usar para obter informações publicamente listadas sobre Google Cloud serviços e SKUs.

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

Aceda a uma lista de serviços Google Cloud públicos

O exemplo seguinte apresenta todos os serviços Google Cloud públicos, incluindo os metadados de cada serviço.

Não precisa de autorizações de IAM específicas para fazer esta chamada de API.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • API_KEY: a sua Google Cloud chave da API.
  • PAGE_SIZE (Opcional): o número de serviços a devolver. A predefinição é 50.
  • PAGE_TOKEN (Opcional): o token de página, que recebe do nextPageToken numa 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 o seu pedido, 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 para o Compute Engine.

Os resultados são paginados e estão limitados a 50 serviços por página. A resposta inclui um nextPageToken que pode usar para obter a página seguinte de resultados. Para obter o lote seguinte, defina pageToken=PAGE_TOKEN. Para reduzir o número de SKUs por página, defina pageSize=PAGE_SIZE. Quando todos os itens tiverem sido apresentados, não é devolvido nenhum token. 

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

Obtenha uma lista de SKUs para um Google Cloud serviço público

O exemplo seguinte apresenta os SKUs públicos de um serviço especificado.

Não precisa de autorizações de IAM específicas para fazer esta chamada de API.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • API_KEY: a sua Google Cloud chave da API.
  • FILTER: os serviços pelos quais filtrar os 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 devolver. A predefinição é 50 e o máximo é 5000.
  • PAGE_TOKEN (Opcional): o token da página, que se encontra 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 o seu pedido, 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 seguinte mostra alguns exemplos de SKUs devolvidos para o Compute Engine. Os resultados são paginados e estão limitados a 50 SKUs por página. A resposta inclui um nextPageToken que pode usar para obter a página seguinte de resultados. Para obter o lote seguinte, defina pageToken=PAGE_TOKEN. Para alterar o número de SKUs por página, defina pageSize=PAGE_SIZE. Quando todos os itens tiverem sido apresentados, não é devolvido nenhum token. 
{
  "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"
}

Obtenha os preços de todos os Google Cloud SKUs públicos

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • SKU_ID: um ID de SKU específico para obter o preço. Para obter preços de todos os SKUs, use "-".
  • API_KEY: a sua Google Cloud chave da API.
  • PAGE_SIZE (Opcional): o número de serviços a devolver. A predefinição é 50.
  • PAGE_TOKEN (Opcional): o token de página, que recebe do nextPageToken numa 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 o seu pedido, 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 de preços para cada ID do SKU.O exemplo abaixo mostra o formato para todos os SKUs públicos, com um tamanho da página de "2".

Os resultados são paginados e, por predefinição, contêm 50 preços por página. A resposta inclui um nextPageToken que pode usar para obter a página seguinte de resultados. Para obter o lote seguinte, defina pageToken=PAGE_TOKEN. Para reduzir o número de resultados por página, defina pageSize=PAGE_SIZE. Quando todos os itens tiverem sido apresentados, não é devolvido nenhum token. 

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

Obtenha o preço de um SKU público

O exemplo seguinte obtém o preço de um SKU listado publicamente. Pode obter uma lista completa dos Google Cloud IDs das SKUs na página SKUs.

Não precisa de autorizações de IAM específicas para fazer esta chamada de API.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • API_KEY: a sua Google Cloud chave da API.
  • SKU_ID: o identificador SKU, que pode obter através do 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 está na mesma moeda que a sua conta de faturação do Google Cloud.

Método HTTP e URL: 

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

Para enviar o seu pedido, 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 seguinte mostra os detalhes dos preços para o ID do 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"
    }
  }
}

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

Os exemplos seguintes mostram chamadas API que obtêm informações específicas da sua conta de faturação do Google Cloud, como SKUs específicos ou informações de preços que podem fazer parte do seu contrato de preços personalizado.

Consoante o recurso da API que estiver a usar, tem de ter estas autorizações para a conta do Cloud Billing:

Se estiver a chamar a API através de uma conta de serviço, esta tem de ter as autorizações.

As seguintes funções predefinidas têm as autorizações para obter informações específicas da sua conta de faturação do Google Cloud:

  • Administrador da conta de faturação
  • Leitor da conta de faturação

Obtenha uma lista de grupos de SKUs para a sua conta do Cloud Billing

Se tiver um contrato de preços com a Google Cloud, o seu contrato pode fazer referência a grupos de SKUs, que contêm SKUs que se enquadram numa categoria específica. Por exemplo, o grupo de SKU do BigQuery contém SKUs para análise e armazenamento do BigQuery em várias localizações.

O exemplo seguinte apresenta os grupos de SKUs disponíveis para a sua conta de faturação do Google Cloud.

Para fazer esta chamada API, precisa da autorização billing.billingAccountSkuGroups.list IAM na sua conta do Cloud Billing.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • BILLING_ACCOUNT_ID: o ID da sua conta do Cloud Billing.
  • PAGE_SIZE (Opcional): o número máximo de grupos de SKUs a devolver. A predefinição é 50 e o máximo é 5000.
  • PAGE_TOKEN (Opcional): o token da página, que se encontra 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 o seu pedido, 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 apresentado abaixo.

Os resultados são paginados e estão limitados a 50 grupos de SKUs por página. A resposta inclui um nextPageToken que pode usar para obter a página seguinte de resultados. Para obter o lote seguinte, defina pageToken=PAGE_TOKEN. Para reduzir o número de SKUs por página, defina pageSize=PAGE_SIZE. Quando todos os itens tiverem sido apresentados, não é devolvido nenhum token. 

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

Obtenha uma lista de SKUs num grupo de SKUs para a sua conta do Cloud Billing

O exemplo seguinte apresenta os SKUs num grupo de SKUs que podem fazer parte do seu contrato de preços personalizado.

Para fazer esta chamada API, precisa da autorização billing.billingAccountSkuGroupSkus.list IAM na sua conta do Cloud Billing.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • SKU_GROUP_ID: o ID do grupo de SKUs, que recebe do billingAccount.skuGroups.list method.
  • BILLING_ACCOUNT_ID: o ID da sua conta do Cloud Billing.
  • PAGE_SIZE (Opcional): o número de grupos de SKUs a obter. A predefinição é 5000.
  • PAGE_TOKEN (Opcional): o token da página, que se encontra 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 o seu pedido, 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 seguinte mostra os 2 primeiros SKUs para o grupo de SKUs Network Data Transfer, com o ID 28934b47-792e-4afa-a025-7720d410482f.

Os resultados são paginados e estão limitados a 5000 grupos de SKUs por página. A resposta inclui um nextPageToken que pode usar para obter a página seguinte de resultados. Para obter o lote seguinte, defina pageToken=PAGE_TOKEN. Para reduzir o número de SKUs por página, defina pageSize=PAGE_SIZE. Quando todos os itens tiverem sido apresentados, não é devolvido nenhum token. 

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

Aceda aos preços de todos os Google Cloud SKUs da sua conta do Cloud Billing

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • SKU_ID: um ID de SKU específico para obter o preço. Para obter preços de todos os SKUs, use "-".
  • API_KEY: a sua Google Cloud chave da API.
  • PAGE_SIZE (Opcional): o número de serviços a devolver. A predefinição é 50.
  • PAGE_TOKEN (Opcional): o token de página, que recebe do nextPageToken numa 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 o seu pedido, 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 SKUs e os respetivos preços, incluindo SKUs que só estão disponíveis para a sua conta de faturação do Google Cloud, e informações de preços para cada SKU. O exemplo abaixo mostra o formato para todos os SKUs, com um tamanho da página de "2".

Os resultados são paginados e, por predefinição, contêm 50 preços por página. A resposta inclui um nextPageToken que pode usar para obter a página seguinte de resultados. Para obter o lote seguinte, defina pageToken=PAGE_TOKEN. Para alterar o número de resultados por página, defina pageSize=PAGE_SIZE. Quando todos os itens tiverem sido apresentados, não é devolvido nenhum token. 

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

Obtenha os preços dos SKUs para a sua conta do Cloud Billing

O exemplo seguinte obtém o preço que está a pagar por um SKU. Se o SKU fizer parte de um contrato de preços personalizado, a resposta inclui informações sobre o desconto no preço de tabela.

Para fazer esta chamada API, precisa da autorização billing.billingAccountPrice.get IAM na sua conta do Cloud Billing.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • SKU_ID: o identificador SKU, que pode obter através do método billingAccounts.skus. O ID é a string após o identificador skus/.
  • BILLING_ACCOUNT_ID: o ID da sua 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 está na mesma moeda que a sua conta de faturação do Google Cloud.

Método HTTP e URL: 

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

Para enviar o seu pedido, 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 a forma como lhe é cobrado o SKU no objeto priceReason. O exemplo seguinte mostra os detalhes dos preços para o ID do SKU 0012-B7F2-DD14. Neste exemplo, a conta de faturação do Google Cloud tem um contrato de preços, mas está a pagar o preço de tabela deste 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": {}
  }
}