Obtenir des informations sur les tarifs de Google Cloud

L'API de tarification Google Cloud est un ensemble de ressources d'API qui vous aident à obtenir les tarifs et autres informations des 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 conservation des stocks spécifique. Un code SKU identifie clairement une ressource que vous pouvez acheter. 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 et obtenir 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

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 répertoriées publiquement sur les services et les codes SKU Google Cloud.

Pour obtenir des informations sur des services publics, des codes SKU ou des prix, 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 pour 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 obtenez 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 illustre le format Compute Engine.

Les résultats sont paginés et sont limités à 50 services par page. La réponse inclut un élément 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 codes 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 permettant de filtrer les codes SKU. Par exemple, pour répertorier les codes SKU pour Compute Engine, utilisez le filtre service="services/DA34-426B-A397".
  • 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 sont limités à 50 codes SKU par page. La réponse inclut un élément 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 modifier le nombre de codes 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 obtenez 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 élément 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 code SKU, que vous pouvez obtenir à l'aide de la méthode skus.list. L'ID est la chaîne située après l'identifiant skus/.
  • CURRENCY (facultatif) : code de devise ISO-4217 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 présente le détail des tarifs 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 codes SKU spécifiques ou des informations sur les tarifs qui pourraient faire partie de votre contrat de tarification personnalisé.

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

  • Pour obtenir des informations sur les services à l'aide de billingAccounts.services, vous devez disposer 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 devez disposer 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 devez disposer 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 sont autorisés à 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 de votre compte de facturation Cloud

Si vous avez un contrat de tarification avec Google Cloud, celui-ci 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 BigQuery dans divers 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 codes SKU, au format indiqué ci-dessous.

Les résultats sont paginés et sont limités à 50 groupes de codes SKU par page. La réponse inclut un élément 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 codes 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 la liste des SKU d'un groupe de 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 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 de groupe de codes SKU provenant 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 codes SKU du groupe de codes SKU Network Data Transfer, avec l'ID 28934b47-792e-4afa-a025-7720d410482f.

Les résultats sont paginés et sont limités à 5 000 groupes de codes SKU par page. La réponse inclut un élément 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 codes 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 obtenez 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 illustre le format de 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 élément 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 modifier 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 de votre compte de facturation Cloud

Dans l'exemple suivant, on récupère le prix que vous payez pour un code SKU. Si le code SKU fait partie d'un contrat de tarification personnalisé, 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 code SKU, que vous pouvez obtenir à l'aide de la méthode billingAccounts.skus. L'ID est la chaîne située après l'identifiant skus/.
  • BILLING_ACCOUNT_ID: votre ID de compte de facturation Cloud.
  • CURRENCY (facultatif) : code de devise ISO-4217 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 informations sur la facturation de ce code SKU dans l'objet priceReason. L'exemple suivant présente le détail des tarifs de l'ID de code SKU 0012-B7F2-DD14. Dans cet exemple, le compte de facturation Cloud est associé à un contrat de tarification, mais le prix catalogue de ce code SKU est facturé. 
{
  "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": {}
  }
}