Obtenir des informations sur les tarifs de Google Cloud

L'API Google Cloud Pricing est un ensemble de ressources API qui vous aide à obtenir les tarifs et d'autres informations sur 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. Exemple de code SKU : Nvidia Tesla T4 GPU attached to Spot Preemptible VMs running in Warsaw. Si vous disposez d'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 et des informations détaillées sur les formats de requête et de réponse, consultez la documentation de référence de l'API.

Avant de commencer

Enable the Cloud Billing API.

Enable the API

Les API sont activées dans un projet Google Cloud. L'API Pricing fait partie de l'API Cloud Billing. Lorsque vous êtes invité à confirmer le projet que vous prévoyez d'utiliser pour l'API Pricing, nous vous recommandons d'utiliser un projet Google Cloud configuré pour contenir tous vos besoins d'administration FinOps et de facturation pour un compte de facturation Cloud. Ce projet peut contenir toutes les API spécifiques à la facturation, y compris l'API Cloud Billing.

Découvrez les avantages d'un projet axé sur FinOps pour vos propres cas d'administration de la facturation.

Obtenir des informations sur les services publics et les tarifs

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

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

Obtenir la liste des services Google Cloud publics

L'exemple suivant liste 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 chacun d'eux. L'exemple ci-dessous montre 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, qui vous permet d'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 liste les SKU publics d'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 afficher 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 présente 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 objet nextPageToken, qui vous permet d'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 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, qui vous permet d'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 obtient 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 qui suit l'identifiant skus/.
  • CURRENCY: (facultatif) Code de devise ISO-4217 du prix. S'il n'est pas spécifié, le prix est indiqué dans la devise de 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 présente les détails de tarification de l'ID de 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 montrent des appels d'API qui obtiennent des informations spécifiques à votre compte de facturation Cloud, telles que des SKU spécifiques ou des informations tarifaires pouvant faire partie de votre contrat de 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 pour 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 dSKU BigQuery contient des articles pour l'analyse et le stockage BigQuery dans différents emplacements.

L'exemple suivant liste les groupes de 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 codes 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, qui vous permet d'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 liste les codes SKU d'un groupe de codes SKU pouvant faire partie de votre contrat de 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 SKU, que vous obtenez à 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 codes SKU par page. La réponse inclut un objet nextPageToken, qui vous permet d'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 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 affiche le format pour tous les codes 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, qui vous permet d'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 SKU pour votre compte de facturation Cloud

L'exemple suivant obtient le prix que vous payez pour un SKU. Si le code SKU fait partie d'un contrat de tarification personnalisée, la réponse inclut des informations sur la remise sur le 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 qui suit l'identifiant skus/.
  • BILLING_ACCOUNT_ID : votre ID de compte de facturation Cloud.
  • CURRENCY: (facultatif) Code de devise ISO-4217 du prix. S'il n'est pas spécifié, le prix est indiqué dans la devise de 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 informations sur la façon dont vous êtes facturé pour le SKU, dans l'objet priceReason. L'exemple suivant présente les détails de tarification de l'ID de code SKU 0012-B7F2-DD14. Dans cet exemple, le compte de facturation Cloud dispose d'un contrat de tarification, mais paie le prix catalogue pour ce 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": {}
  }
}