Informazioni sui prezzi di Google Cloud

L'API Google Cloud Pricing è un insieme di risorse API che ti aiutano a ottenere i prezzi e altre informazioni per i servizi Google Cloud.

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

Puoi utilizzare l'API Pricing per ottenere un elenco di servizi o il prezzo per un codice identificativo dell'articolo (SKU) specifico. Uno SKU identifica in modo distinto 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 prezzi personalizzati, puoi anche utilizzare l'API Pricing per ottenere i prezzi personalizzati associati al tuo account di fatturazione Cloud.

Per un elenco completo delle risorse disponibili nell'API Pricing e per informazioni dettagliate sui formati di richiesta e risposta, consulta il riferimento all'API.

Prima di iniziare

Enable the Cloud Billing API.

Enable the API

Le API sono abilitate in un progetto Google Cloud. L'API Pricing fa parte dell'API Cloud Billing. Quando ti viene chiesto di confermare il progetto che intendi utilizzare per l'API Pricing, ti consigliamo di utilizzare un progetto Google Cloud configurato per contenere tutte le tue esigenze di amministrazione della fatturazione e FinOps per un account di fatturazione Cloud. Questo progetto può contenere tutte le API specifiche per la fatturazione, inclusa l'API Cloud Billing.

Scopri di più sui vantaggi dell'utilizzo di un progetto incentrato su FinOps per i casi d'uso di amministrazione della fatturazione.

Ricevere informazioni sui servizi pubblici e sui prezzi

Gli esempi seguenti mostrano le chiamate API che puoi utilizzare per ottenere informazioni elencate pubblicamente su servizi e SKU di Google Cloud.

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

Ottenere un elenco dei servizi Google Cloud pubblici

L'esempio seguente elenca tutti i servizi pubblici Google Cloud, inclusi i metadati di ciascun servizio.

Non sono necessarie autorizzazioni IAM specifiche per effettuare questa chiamata API.

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

  • API_KEY: la tua chiave API Google Cloud.
  • PAGE_SIZE (facoltativo): il numero di servizi da restituire. Il valore predefinito è 50.
  • PAGE_TOKEN (Facoltativo): il token di pagina, che ottieni 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 ciascun servizio. L'esempio seguente mostra il formato per Compute Engine.

I risultati sono suddivisi in pagine e sono limitati a 50 servizi per pagina. La risposta include un nextPageToken che puoi utilizzare per ottenere la pagina successiva dei risultati. Per recuperare il batch successivo, imposta pageToken=PAGE_TOKEN. Per ridurre il numero di SKU per pagina, imposta pageSize=PAGE_SIZE. Quando tutti gli elementi sono stati elencati, non viene restituito alcun token. 

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

Ottenere un elenco di SKU per un servizio pubblico Google Cloud

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

Non sono necessarie autorizzazioni IAM specifiche per effettuare questa chiamata API.

Prima di utilizzare i dati della richiesta, apporta 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".
  • PAGE_SIZE (Facoltativo): il numero massimo di SKU da restituire. Il valore predefinito è 50 e il massimo è 5000.
  • PAGE_TOKEN (Facoltativo): il token pagina, che si trova in 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 seguente risposta mostra alcuni SKU di esempio restituiti per Compute Engine. I risultati sono suddivisi in pagine e sono limitati a 50 SKU per pagina. La risposta include un nextPageToken che puoi utilizzare per ottenere la pagina successiva dei risultati. Per recuperare il batch successivo, imposta pageToken=PAGE_TOKEN. Per modificare il numero di SKU per pagina, imposta pageSize=PAGE_SIZE. Quando tutti gli elementi sono stati elencati, 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 di tutti gli SKU pubblici di Google Cloud

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

  • SKU_ID: un ID SKU specifico per il quale ottenere il prezzo. Per ottenere i prezzi di tutti gli SKU, utilizza "-".
  • API_KEY: la tua chiave API Google Cloud.
  • PAGE_SIZE (facoltativo): il numero di servizi da restituire. Il valore predefinito è 50.
  • PAGE_TOKEN (Facoltativo): il token di pagina, che ottieni 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 per tutti gli SKU pubblici, con un numero di pagine pari a "2".

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

Ottenere il prezzo di uno SKU pubblico

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

Non sono necessarie autorizzazioni IAM specifiche per effettuare questa chiamata API.

Prima di utilizzare i dati della richiesta, apporta 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 è 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"
    }
  }
}

Visualizzare informazioni specifiche per il tuo account di fatturazione Cloud

Gli esempi seguenti mostrano le chiamate API che recuperano informazioni specifiche per il tuo account di fatturazione Cloud, ad esempio SKU specifici o informazioni sui prezzi che potrebbero far parte del tuo contratto con prezzi personalizzati.

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

  • Per ricevere informazioni sui servizi che utilizzano billingAccounts.services, è necessario:

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

  • Per ottenere informazioni sugli SKU utilizzando billingAccounts.skus, è necessario:

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

  • Per ottenere informazioni sui gruppi di SKU utilizzando billingAccounts.skugroups, è necessario:

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

  • Per ottenere informazioni sugli SKU che fanno parte dei gruppi di SKU utilizzando billingAccounts.skugroups.skus, è necessario:

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

  • Per ottenere informazioni sui prezzi degli SKU utilizzando billingAccounts.skus.price, è necessario:

    • billing.billingAccountPrice.get

Se chiami l'API utilizzando un account di servizio, questo deve disporre delle autorizzazioni.

I seguenti ruoli predefiniti dispongono delle autorizzazioni per recuperare informazioni specifiche per il tuo account di fatturazione Cloud:

  • Amministratore account di fatturazione
  • Visualizzatore account di fatturazione

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

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

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

Per effettuare questa chiamata API, devi disporre dell'autorizzazione IAM billing.billingAccountSkuGroups.list nel tuo account di fatturazione Cloud.

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

  • BILLING_ACCOUNT_ID: il tuo ID account di fatturazione Cloud.
  • PAGE_SIZE (Facoltativo): il numero massimo di gruppi di SKU da restituire. Il valore predefinito è 50 e il massimo è 5000.
  • PAGE_TOKEN (Facoltativo): il token pagina, che si trova in 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 sono suddivisi in pagine e sono limitati a 50 gruppi di SKU per pagina. La risposta include un nextPageToken che puoi utilizzare per ottenere la pagina successiva dei risultati. Per recuperare il batch successivo, imposta pageToken=PAGE_TOKEN. Per ridurre il numero di SKU per pagina, imposta pageSize=PAGE_SIZE. Quando tutti gli elementi sono stati elencati, 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"
}

Ottenere 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, devi disporre dell'autorizzazione IAM billing.billingAccountSkuGroupSkus.list nel tuo account di fatturazione Cloud.

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

  • SKU_GROUP_ID: l'ID gruppo di SKU, che puoi ottenere da billingAccount.skuGroups.list method.
  • BILLING_ACCOUNT_ID: il tuo ID account di fatturazione Cloud.
  • PAGE_SIZE (Facoltativo): il numero di gruppi di SKU da ottenere. Il valore predefinito è 5000.
  • PAGE_TOKEN (Facoltativo): il token pagina, che si trova in 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 due SKU per il gruppo di SKU Network Data Transfer, con l'ID 28934b47-792e-4afa-a025-7720d410482f.

I risultati sono suddivisi in pagine e sono limitati a 5000 gruppi di SKU per pagina. La risposta include un nextPageToken che puoi utilizzare per ottenere la pagina successiva dei risultati. Per recuperare il batch successivo, imposta pageToken=PAGE_TOKEN. Per ridurre il numero di SKU per pagina, imposta pageSize=PAGE_SIZE. Quando tutti gli elementi sono stati elencati, 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"
}

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

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

  • SKU_ID: un ID SKU specifico per il quale ottenere il prezzo. Per ottenere i prezzi di tutti gli SKU, utilizza "-".
  • API_KEY: la tua chiave API Google Cloud.
  • PAGE_SIZE (facoltativo): il numero di servizi da restituire. Il valore predefinito è 50.
  • PAGE_TOKEN (Facoltativo): il token di pagina, che ottieni 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 relativi prezzi, inclusi gli SKU disponibili solo per il tuo account di fatturazione Cloud, nonché informazioni sui prezzi di ciascun SKU. L'esempio seguente mostra il formato per tutti gli SKU, con un formato pagina di "2".

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

Visualizzare i prezzi degli SKU per il tuo account di fatturazione Cloud

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

Per effettuare questa chiamata API, devi disporre dell'autorizzazione IAM billing.billingAccountPrice.get nel tuo account di fatturazione Cloud.

Prima di utilizzare i dati della richiesta, apporta 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: il tuo ID account di fatturazione Cloud.
  • CURRENCY: (facoltativo) il codice valuta ISO 4217 per il prezzo. Se non specificato, il prezzo è 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 dettagli su come ti viene addebitato 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 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": {}
  }
}