Obtenir des informations sur les tarifs de Google Cloud

L'API Google Cloud Pricing est un ensemble de ressources d'API qui vous aide à obtenir les tarifs et d'autres informations concernant les services Google Cloud.

Cette page présente quelques exemples de requêtes API que vous pouvez effectuer pour obtenir des informations sur les services et les SKU répertoriés publiquement, ainsi que sur les services et les SKU disponibles uniquement dans votre compte de facturation Cloud dans le cadre d'un contrat avec Google Cloud.

Vous pouvez utiliser l'API Pricing pour obtenir la liste des services ou le prix d'une unité de gestion des stocks (code SKU) spécifique. Un SKU identifie de manière spécifique une ressource disponible à l'achat. Voici un exemple de code SKU : Nvidia Tesla K80 GPU attached to Spot Preemptible VMs running in Warsaw. Si vous avez un contrat avec une tarification personnalisée, vous pouvez également utiliser l'API Pricing pour obtenir les tarifs personnalisés associés à votre compte de facturation Cloud.

Pour obtenir la liste complète des ressources disponibles dans l'API Pricing, ainsi que des informations détaillées sur les formats de requêtes et de réponses, consultez la documentation de référence sur l'API.

Avant de commencer

Activez l'API Cloud Billing

Activer l'API

Obtenir des informations sur les services publics et les tarifs

Les exemples suivants montrent des appels d'API que vous pouvez utiliser pour obtenir des informations publiques sur les services Google Cloud et les codes SKU.

Pour obtenir des informations sur les services publics, les SKU ou les tarifs, vous devez créer une clé API.

Obtenir la liste des services Google Cloud publics

L'exemple suivant répertorie tous les services Google Cloud publics, y compris les métadonnées de chaque service.

Vous n'avez pas besoin d'autorisations IAM spécifiques pour effectuer cet appel d'API.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • API_KEY : votre clé API Google Cloud.
  • PAGE_SIZE (facultatif) : nombre de services à renvoyer. La valeur par défaut est 50.
  • PAGE_TOKEN (facultatif) : jeton de page, que vous avez obtenu à partir de nextPageToken dans une réponse précédente.

Méthode HTTP et URL :

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

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Exécutez la commande suivante :

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

PowerShell

Exécutez la commande suivante :

$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

La réponse contient une liste de services et des informations sur chaque service. L'exemple ci-dessous présente le format pour Compute Engine.

Les résultats sont paginés et limités à 50 services par page. La réponse inclut un objet nextPageToken, que vous pouvez utiliser pour obtenir la page de résultats suivante. Pour récupérer le lot suivant, définissez pageToken=PAGE_TOKEN. Pour réduire le nombre de SKU par page, définissez pageSize=PAGE_SIZE. Lorsque tous les éléments ont été répertoriés, aucun jeton n'est renvoyé.

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

Obtenir la liste des SKU pour un service Google Cloud public

L'exemple suivant répertorie les SKU publics pour un service spécifié.

Vous n'avez pas besoin d'autorisations IAM spécifiques pour effectuer cet appel d'API.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • API_KEY : votre clé API Google Cloud.
  • FILTER : services par lesquels filtrer les codes SKU. Par exemple, pour répertorier les codes SKU de Compute Engine, utilisez le filtre service="services/6F81-5844-456A".
  • PAGE_SIZE (facultatif) : nombre maximal de codes SKU à renvoyer. La valeur par défaut est 50 et la valeur maximale est 5 000.
  • PAGE_TOKEN (facultatif) : jeton de page, qui se trouve dans nextPageToken dans la réponse.

Méthode HTTP et URL :

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

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Exécutez la commande suivante :

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

PowerShell

Exécutez la commande suivante :

$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
La réponse suivante montre quelques exemples de codes SKU renvoyés pour Compute Engine. Les résultats sont paginés et limités à 50 codes SKU par page. La réponse inclut un nextPageToken que vous pouvez utiliser pour obtenir la page de résultats suivante. Pour récupérer le lot suivant, définissez pageToken=PAGE_TOKEN. Pour réduire le nombre de SKU par page, définissez pageSize=PAGE_SIZE. Lorsque tous les éléments ont été répertoriés, aucun jeton n'est renvoyé.
{
  "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"
}

Obtenir les tarifs de tous les codes SKU Google Cloud publics

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • SKU_ID : ID du code SKU spécifique pour lequel vous souhaitez obtenir le prix. Pour obtenir les prix de tous les codes SKU, utilisez "-".
  • API_KEY : votre clé API Google Cloud.
  • PAGE_SIZE (facultatif) : nombre de services à renvoyer. La valeur par défaut est 50.
  • PAGE_TOKEN (facultatif) : jeton de page, que vous avez obtenu à partir de nextPageToken dans une réponse précédente.

Méthode HTTP et URL :

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

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Exécutez la commande suivante :

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

PowerShell

Exécutez la commande suivante :

$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

La réponse contient des informations de tarification pour chaque ID de code SKU. L'exemple ci-dessous affiche le format pour tous les codes SKU publics, avec une taille de page de "2".

Les résultats sont paginés et contiennent par défaut 50 prix par page. La réponse inclut un objet nextPageToken, que vous pouvez utiliser pour obtenir la page de résultats suivante. Pour récupérer le lot suivant, définissez pageToken=PAGE_TOKEN. Pour réduire le nombre de résultats par page, définissez pageSize=PAGE_SIZE. Lorsque tous les éléments ont été répertoriés, aucun jeton n'est renvoyé.

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

Obtenir le prix d'un code SKU public

L'exemple suivant récupère le prix d'un code SKU public. Vous pouvez obtenir la liste complète des ID de SKU Google Cloud sur la page des SKU.

Vous n'avez pas besoin d'autorisations IAM spécifiques pour effectuer cet appel d'API.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • API_KEY : votre clé API Google Cloud.
  • SKU_ID : identifiant du SKU, que vous pouvez obtenir à l'aide de la méthode skus.list. L'ID correspond à la chaîne située après l'identifiant skus/.
  • CURRENCY (facultatif) : code ISO-4217 de la devise pour le prix. S'il n'est pas spécifié, le prix est dans la même devise que votre compte de facturation Cloud.

Méthode HTTP et URL :

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

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Exécutez la commande suivante :

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

PowerShell

Exécutez la commande suivante :

$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
L'exemple suivant montre les détails des tarifs pour l'ID du code 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"
    }
  }
}

Obtenir des informations spécifiques à votre compte de facturation Cloud

Les exemples suivants illustrent les appels d'API qui obtiennent des informations spécifiques à votre compte de facturation Cloud, telles que des codes SKU spécifiques ou des informations tarifaires pouvant faire partie de votre contrat soumis à tarification personnalisée.

Selon la ressource d'API que vous utilisez, vous devez disposer des autorisations suivantes pour le compte de facturation Cloud :

  • Pour obtenir des informations sur les services utilisant billingAccounts.services, vous avez besoin des éléments suivants :

    • billing.billingAccountServices.get
    • billing.billingAccountServices.list
  • Pour obtenir des informations sur les codes SKU à l'aide de billingAccounts.skus, vous avez besoin des éléments suivants :

    • billing.billingAccountSkus.get
    • billing.billingAccountSkus.list
  • Pour obtenir des informations sur les groupes de codes SKU à l'aide de billingAccounts.skugroups, vous avez besoin des éléments suivants :

    • billing.billingAccountSkuGroups.get
    • billing.billingAccountSkuGroups.list
  • Pour obtenir des informations sur les codes SKU faisant partie de groupes de codes SKU à l'aide de billingAccounts.skugroups.skus, vous avez besoin des éléments suivants :

    • billing.billingAccountSkuGroupSkus.get
    • billing.billingAccountSkuGroupSkus.list
  • Pour obtenir des informations sur les tarifs des codes SKU à l'aide de billingAccounts.skus.price, vous avez besoin des éléments suivants :

    • billing.billingAccountPrice.get

Si vous appelez l'API à l'aide d'un compte de service, celui-ci doit disposer de cette autorisation.

Les rôles prédéfinis suivants disposent des autorisations nécessaires pour obtenir des informations spécifiques à votre compte de facturation Cloud :

  • Administrateur de compte de facturation
  • Lecteur de compte de facturation

Obtenir la liste des groupes de codes SKU associés à votre compte de facturation Cloud

Si vous avez un contrat de tarification avec Google Cloud, votre contrat peut faire référence à des groupes de codes SKU, qui contiennent des codes SKU appartenant à une catégorie spécifique. Par exemple, le groupe de codes SKU BigQuery contient des codes SKU pour l'analyse et le stockage de BigQuery à différents emplacements.

L'exemple suivant répertorie les groupes de codes SKU disponibles pour votre compte de facturation Cloud.

Pour effectuer cet appel d'API, vous devez disposer de l'autorisation IAM billing.billingAccountSkuGroups.list sur votre compte de facturation Cloud.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • BILLING_ACCOUNT_ID : votre ID de compte de facturation Cloud.
  • PAGE_SIZE (facultatif) : nombre maximal de groupes de codes SKU à renvoyer. La valeur par défaut est 50 et la valeur maximale est 5 000.
  • PAGE_TOKEN (facultatif) : jeton de page, qui se trouve dans nextPageToken dans la réponse.

Méthode HTTP et URL :

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

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Exécutez la commande suivante :

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

Exécutez la commande suivante :

$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

La réponse est une liste de groupes de SKU, au format indiqué ci-dessous.

Les résultats sont paginés et limités à 50 groupes de SKU par page. La réponse inclut un objet nextPageToken, que vous pouvez utiliser pour obtenir la page de résultats suivante. Pour récupérer le lot suivant, définissez pageToken=PAGE_TOKEN. Pour réduire le nombre de SKU par page, définissez pageSize=PAGE_SIZE. Lorsque tous les éléments ont été répertoriés, aucun jeton n'est renvoyé.

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

Obtenir une liste des SKU dans un groupe de codes SKU pour votre compte de facturation Cloud

L'exemple suivant répertorie les codes SKU d'un groupe de codes SKU pouvant faire partie de votre contrat soumis à tarification personnalisée.

Pour effectuer cet appel d'API, vous devez disposer de l'autorisation IAM billing.billingAccountSkuGroupSkus.list sur votre compte de facturation Cloud.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • SKU_GROUP_ID: ID du groupe de codes SKU, obtenu à partir de billingAccount.skuGroups.list method.
  • BILLING_ACCOUNT_ID : votre ID de compte de facturation Cloud.
  • PAGE_SIZE (facultatif) : nombre de groupes de codes SKU à obtenir. La valeur par défaut est 5 000.
  • PAGE_TOKEN (facultatif) : jeton de page, qui se trouve dans nextPageToken dans la réponse.

Méthode HTTP et URL :

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

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Exécutez la commande suivante :

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

Exécutez la commande suivante :

$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

L'exemple suivant montre les deux premiers SKU du groupe de codes SKU Network Data Transfer, avec l'ID 28934b47-792e-4afa-a025-7720d410482f.

Les résultats sont paginés et limités à 5 000 groupes de SKU par page. La réponse inclut un objet nextPageToken, que vous pouvez utiliser pour obtenir la page de résultats suivante. Pour récupérer le lot suivant, définissez pageToken=PAGE_TOKEN. Pour réduire le nombre de SKU par page, définissez pageSize=PAGE_SIZE. Lorsque tous les éléments ont été répertoriés, aucun jeton n'est renvoyé.

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

Obtenir les tarifs de tous les codes SKU Google Cloud pour votre compte de facturation Cloud

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • SKU_ID : ID du code SKU spécifique pour lequel vous souhaitez obtenir le prix. Pour obtenir les prix de tous les codes SKU, utilisez "-".
  • API_KEY : votre clé API Google Cloud.
  • PAGE_SIZE (facultatif) : nombre de services à renvoyer. La valeur par défaut est 50.
  • PAGE_TOKEN (facultatif) : jeton de page, que vous avez obtenu à partir de nextPageToken dans une réponse précédente.

Méthode HTTP et URL :

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

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Exécutez la commande suivante :

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

Exécutez la commande suivante :

$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

La réponse contient la liste des ID de codes SKU et leurs tarifs, y compris les codes SKU qui ne sont disponibles que pour votre compte de facturation Cloud, ainsi que les informations de tarification de chaque code SKU. L'exemple ci-dessous présente le format de tous les SKU, avec une taille de page de "2".

Les résultats sont paginés et contiennent par défaut 50 prix par page. La réponse inclut un objet nextPageToken, que vous pouvez utiliser pour obtenir la page de résultats suivante. Pour récupérer le lot suivant, définissez pageToken=PAGE_TOKEN. Pour réduire le nombre de résultats par page, définissez pageSize=PAGE_SIZE. Lorsque tous les éléments ont été répertoriés, aucun jeton n'est renvoyé.

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

Obtenir les tarifs des codes SKU pour votre compte de facturation Cloud

L'exemple suivant récupère le prix que vous payez pour un code SKU. Si le code SKU fait partie d'un contrat soumis à tarification personnalisée, la réponse inclut des informations sur la remise appliquée au prix catalogue.

Pour effectuer cet appel d'API, vous devez disposer de l'autorisation IAM billing.billingAccountPrice.get sur votre compte de facturation Cloud.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • SKU_ID : identifiant du SKU, que vous pouvez obtenir à l'aide de la méthode billingAccounts.skus. L'ID correspond à la chaîne située après l'identifiant skus/.
  • BILLING_ACCOUNT_ID : votre ID de compte de facturation Cloud.
  • CURRENCY (facultatif) : code ISO-4217 de la devise pour le prix. S'il n'est pas spécifié, le prix est dans la même devise que votre compte de facturation Cloud.

Méthode HTTP et URL :

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

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Exécutez la commande suivante :

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

Exécutez la commande suivante :

$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
La réponse contient des détails sur le mode de facturation du code SKU dans l'objet priceReason. L'exemple suivant montre les détails des tarifs pour l'ID du code SKU 0012-B7F2-DD14. Dans cet exemple, le compte de facturation Cloud est associé à un contrat soumis à tarification, mais il paie le prix catalogue pour ce code 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": {}
  }
}