Informazioni sui prezzi di Google Cloud

L'API dei prezzi di Google Cloud è un insieme di risorse API che ti aiuta a ottenere i prezzi e altre informazioni sui servizi Google Cloud.

Questa pagina mostra alcuni esempi di richieste API che puoi effettuare per ottenere informazioni sui servizi e sugli SKU elencati pubblicamente, nonché sui servizi e SKU disponibili solo per il tuo account di fatturazione Cloud nell'ambito di un un contratto con Google Cloud.

Puoi utilizzare l'API dei prezzi per ottenere un elenco dei servizi o il prezzo per uno specifico codice identificativo dell'articolo (SKU). Uno SKU identifica in modo univoco una risorsa che puoi acquistare. Un esempio di SKU è Nvidia Tesla T4 GPU attached to Spot Preemptible VMs running in Warsaw. Se hai un contratto con dei prezzi, puoi anche usare l'API dei prezzi per ottenere prezzi personalizzati associati al tuo account di fatturazione Cloud.

Per un elenco completo delle risorse disponibili nell'API dei prezzi e per informazioni dettagliate sui formati di richiesta e risposta, consulta la documentazione di riferimento dell'API.

Prima di iniziare

Attiva l'API Cloud Billing.

Abilita l'API

Ricevere informazioni sul servizio pubblico e sui prezzi

Gli esempi seguenti mostrano le chiamate API che puoi utilizzare per essere elencate pubblicamente informazioni sui servizi Google Cloud e sugli SKU.

Per ottenere informazioni su servizi pubblici, SKU o prezzi, devi creare un API chiave.

Ottieni un elenco dei servizi pubblici di Google Cloud

L'esempio seguente elenca tutti i servizi Google Cloud pubblici, tra cui e i metadati per ogni servizio.

Non hai bisogno di autorizzazioni IAM specifiche per creare questa API chiamata.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • API_KEY: la tua chiave API Google Cloud.
  • (Facoltativo) PAGE_SIZE: il numero di servizi da restituire. Il valore predefinito è 50.
  • (Facoltativo) PAGE_TOKEN: il token di pagina che ricevi da nextPageToken in una risposta precedente.

Metodo HTTP e URL: 

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

Per inviare la richiesta, scegli una delle seguenti opzioni:

curl

Esegui questo comando: 

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

PowerShell

Esegui questo 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

La risposta contiene un elenco di servizi e informazioni su ciascuno di essi. L'esempio seguente mostra il formato per Compute Engine.

I risultati vengono impaginati e sono limitati a 50 servizi per pagina. La la risposta include un valore nextPageToken che puoi utilizzare per visualizzare la pagina successiva di risultati. Per recuperare il batch successivo, imposta pageToken=PAGE_TOKEN. Per ridurre il numero di SKU per pagina, imposta pageSize=PAGE_SIZE. Dopo che tutti gli elementi sono stati non viene restituito alcun token. 

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

Ottieni un elenco di SKU per un servizio Google Cloud pubblico

L'esempio seguente elenca gli SKU pubblici per un servizio specificato.

Non hai bisogno di autorizzazioni IAM specifiche per creare questa API chiamata.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • API_KEY: la tua chiave API Google Cloud.
  • FILTER: i servizi in base ai quali filtrare gli SKU. Ad esempio, per elencare gli SKU per Compute Engine, utilizza il filtro service="services/6F81-5844-456A".
  • (Facoltativo) PAGE_SIZE: il numero massimo di SKU da restituire. Il valore predefinito è 50 e il massimo è 5000.
  • PAGE_TOKEN (facoltativo): il token della pagina, che si trova nel campo nextPageToken nella risposta.

Metodo HTTP e URL: 

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

Per inviare la richiesta, scegli una delle seguenti opzioni:

curl

Esegui questo comando: 

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

PowerShell

Esegui questo 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
La risposta seguente mostra alcuni SKU di esempio restituiti per Compute Engine. I risultati vengono impaginati e sono limitati a 50 SKU per pagina. La la risposta include un valore nextPageToken che puoi utilizzare per visualizzare la pagina successiva di risultati. Per recuperare il batch successivo, imposta pageToken=PAGE_TOKEN. Per modificare il numero di SKU per pagina, imposta pageSize=PAGE_SIZE. Dopo che tutti gli elementi sono stati non viene restituito alcun 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"
}

Visualizza i prezzi per tutti gli SKU pubblici di Google Cloud

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • SKU_ID: uno specifico ID SKU per il quale ottenere il prezzo. Per ottenere i prezzi per tutti gli SKU, utilizza "-".
  • API_KEY: la tua chiave API Google Cloud.
  • (Facoltativo) PAGE_SIZE: il numero di servizi da restituire. Il valore predefinito è 50.
  • (Facoltativo) PAGE_TOKEN: il token di pagina che ricevi da nextPageToken in una risposta precedente.

Metodo HTTP e URL: 

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

Per inviare la richiesta, scegli una delle seguenti opzioni:

curl

Esegui questo comando: 

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

PowerShell

Esegui questo 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

La risposta contiene informazioni sui prezzi per ogni ID SKU.L'esempio seguente mostra il formato di tutti gli SKU pubblici, con una dimensione di pagina di "2".

I risultati sono suddivisi in pagine e, per impostazione predefinita, contengono 50 prezzi per pagina. La la risposta include un valore nextPageToken che puoi utilizzare per visualizzare la pagina successiva di risultati. Per recuperare il batch successivo, imposta pageToken=PAGE_TOKEN. Per ridurre il numero di risultati per pagina, imposta pageSize=PAGE_SIZE. Dopo che tutti gli elementi sono stati non viene restituito alcun 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"
}

Visualizza il prezzo di uno SKU pubblico

L'esempio seguente restituisce il prezzo di uno SKU elencato pubblicamente. Puoi ottenere un elenco completo degli ID SKU di Google Cloud nella pagina degli SKU.

Non hai bisogno di autorizzazioni IAM specifiche per creare questa API chiamata.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • API_KEY: la tua chiave API Google Cloud.
  • SKU_ID: l'identificatore SKU, che puoi ottenere utilizzando il metodo skus.list. L'ID è la stringa dopo l'identificatore skus/.
  • CURRENCY (Facoltativo) Il codice valuta ISO-4217 per il prezzo. Se non specificato, il prezzo viene indicato nella stessa valuta del tuo account di fatturazione Cloud.

Metodo HTTP e URL: 

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

Per inviare la richiesta, scegli una delle seguenti opzioni:

curl

Esegui questo comando: 

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

PowerShell

Esegui questo 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
L'esempio seguente mostra i dettagli dei prezzi per l'ID 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"
    }
  }
}

Ottieni informazioni specifiche per il tuo account di fatturazione Cloud

Gli esempi seguenti mostrano le chiamate API che ricevono informazioni specifiche per l'account di fatturazione Cloud, ad esempio SKU o prezzi specifici le informazioni che potrebbero far parte del contratto relativo ai prezzi personalizzati.

A seconda della risorsa API che utilizzi, devi disporre di queste autorizzazioni per l'account di fatturazione Cloud:

  • Per ottenere informazioni sui servizi che utilizzano billingAccounts.services, ti servono:

    • billing.billingAccountServices.get
    • billing.billingAccountServices.list

  • Per ottenere informazioni sugli SKU utilizzando billingAccounts.skus, ti servono:

    • billing.billingAccountSkus.get
    • billing.billingAccountSkus.list

  • Per ottenere informazioni sui gruppi di SKU utilizzando billingAccounts.skugroups, ti servono:

    • billing.billingAccountSkuGroups.get
    • billing.billingAccountSkuGroups.list

  • Per ottenere informazioni sugli SKU che fanno parte di gruppi di SKU utilizzando billingAccounts.skugroups.skus, ti servono:

    • billing.billingAccountSkuGroupSkus.get
    • billing.billingAccountSkuGroupSkus.list

  • Per ottenere informazioni sui prezzi degli SKU utilizzando billingAccounts.skus.price, ti servono:

    • billing.billingAccountPrice.get

Se chiami l'API utilizzando un account di servizio, quest'ultimo deve avere le autorizzazioni.

I seguenti ruoli predefiniti hanno le autorizzazioni per ottenere informazioni specifiche al tuo account di fatturazione Cloud:

  • Amministratore account di fatturazione
  • Visualizzatore account di fatturazione

Ottieni un elenco di gruppi di SKU per il tuo account di fatturazione Cloud

Se hai un contratto con i prezzi con Google Cloud, il contratto potrebbe fare riferimento ai gruppi di SKU, che contengono SKU che rientrano in una categoria specifica. Ad esempio, BigQuery Il gruppo di SKU contiene SKU per l'analisi e l'archiviazione di BigQuery in in varie località.

L'esempio seguente elenca i gruppi di SKU disponibili per il tuo di account di fatturazione Cloud.

Per effettuare questa chiamata API, è necessario billing.billingAccountSkuGroups.list Autorizzazione IAM sul tuo account di fatturazione Cloud.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • BILLING_ACCOUNT_ID: l'ID del tuo account di fatturazione Cloud.
  • (Facoltativo) PAGE_SIZE: il numero massimo di gruppi di SKU da restituire. Il valore predefinito è 50 e il massimo è 5000.
  • PAGE_TOKEN (facoltativo): il token della pagina, che si trova nel campo nextPageToken nella risposta.

Metodo HTTP e URL: 

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

Per inviare la richiesta, scegli una delle seguenti opzioni:

curl

Esegui questo 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

Esegui questo 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

La risposta è un elenco di gruppi di SKU nel formato mostrato di seguito.

I risultati vengono impaginati e sono limitati a 50 gruppi di SKU per pagina. La la risposta include un valore nextPageToken che puoi utilizzare per visualizzare la pagina successiva di risultati. Per recuperare il batch successivo, imposta pageToken=PAGE_TOKEN. Per ridurre il numero di SKU per pagina, imposta pageSize=PAGE_SIZE. Dopo che tutti gli elementi sono stati non viene restituito alcun 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"
}

Ottieni un elenco di SKU in un gruppo di SKU per il tuo account di fatturazione Cloud

L'esempio seguente elenca gli SKU in un gruppo di SKU che potrebbero far parte del tuo contratto con prezzi personalizzati.

Per effettuare questa chiamata API, è necessario billing.billingAccountSkuGroupSkus.list Autorizzazione IAM sul tuo account di fatturazione Cloud.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • SKU_GROUP_ID: l'ID gruppo di SKU, recuperato da billingAccount.skuGroups.list method.
  • BILLING_ACCOUNT_ID: l'ID del tuo account di fatturazione Cloud.
  • (Facoltativo) PAGE_SIZE: il numero di gruppi di SKU da ricevere. Il valore predefinito è 5000.
  • PAGE_TOKEN (facoltativo): il token della pagina, che si trova nel campo nextPageToken nella risposta.

Metodo HTTP e URL: 

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

Per inviare la richiesta, scegli una delle seguenti opzioni:

curl

Esegui questo 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

Esegui questo 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

L'esempio seguente mostra i primi 2 SKU del gruppo di SKU Network Data Transfer, con l'ID 28934b47-792e-4afa-a025-7720d410482f.

I risultati vengono impaginati e sono limitati a 5000 gruppi di SKU per pagina. La la risposta include un valore nextPageToken che puoi utilizzare per visualizzare la pagina successiva di risultati. Per recuperare il batch successivo, imposta pageToken=PAGE_TOKEN. Per ridurre il numero di SKU per pagina, imposta pageSize=PAGE_SIZE. Dopo che tutti gli elementi sono stati non viene restituito alcun 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"
}

Ottieni i prezzi per tutti gli SKU di Google Cloud per il tuo account di fatturazione Cloud

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • SKU_ID: uno specifico ID SKU per il quale ottenere il prezzo. Per ottenere i prezzi per tutti gli SKU, utilizza "-".
  • API_KEY: la tua chiave API Google Cloud.
  • (Facoltativo) PAGE_SIZE: il numero di servizi da restituire. Il valore predefinito è 50.
  • (Facoltativo) PAGE_TOKEN: il token di pagina che ricevi da nextPageToken in una risposta precedente.

Metodo HTTP e URL: 

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

Per inviare la richiesta, scegli una delle seguenti opzioni:

curl

Esegui questo 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

Esegui questo 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

La risposta contiene un elenco di ID SKU e i relativi prezzi, inclusi gli SKU disponibili solo per il tuo account di fatturazione Cloud, e le informazioni sui prezzi per ogni SKU. L'esempio seguente mostra il formato per tutti gli SKU, con una dimensione di pagina pari a "2".

I risultati sono suddivisi in pagine e, per impostazione predefinita, contengono 50 prezzi per pagina. La la risposta include un valore nextPageToken che puoi utilizzare per visualizzare la pagina successiva di risultati. Per recuperare il batch successivo, imposta pageToken=PAGE_TOKEN. Per modificare il numero di risultati per pagina, imposta pageSize=PAGE_SIZE. Dopo che tutti gli elementi sono stati non viene restituito alcun 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"
}

Visualizza i prezzi per gli SKU per il tuo account di fatturazione Cloud

L'esempio seguente restituisce il prezzo che stai pagando per uno SKU. Se lo SKU è parte di un contratto con prezzi personalizzati, la risposta include informazioni sul uno sconto sul prezzo di listino.

Per effettuare questa chiamata API, è necessario billing.billingAccountPrice.get Autorizzazione IAM sul tuo account di fatturazione Cloud.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • SKU_ID: l'identificatore SKU, che puoi ottenere utilizzando il metodo billingAccounts.skus. L'ID è la stringa dopo l'identificatore skus/.
  • BILLING_ACCOUNT_ID: l'ID del tuo account di fatturazione Cloud.
  • CURRENCY (Facoltativo) Il codice valuta ISO-4217 per il prezzo. Se non specificato, il prezzo viene indicato nella stessa valuta del tuo account di fatturazione Cloud.

Metodo HTTP e URL: 

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

Per inviare la richiesta, scegli una delle seguenti opzioni:

curl

Esegui questo 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

Esegui questo 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
La risposta contiene i dettagli sulle modalità di addebito per lo SKU, nell'oggetto priceReason. L'esempio seguente mostra i dettagli dei prezzi per l'ID SKU 0012-B7F2-DD14. In questo esempio, l'account di fatturazione Cloud ha un contratto con i prezzi, ma paga il prezzo di listino per questo 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": {}
  }
}