Obtén información sobre los precios de Google Cloud

La API de precios de Google Cloud es un conjunto de recursos de API que te ayuda a obtener los precios y otra información de los servicios de Google Cloud.

En esta página, se muestran algunos ejemplos de solicitudes a la API que puedes realizar para obtener información sobre servicios y SKU enumerados de forma pública, así como servicios y SKU que solo están disponibles para tu cuenta de Facturación de Cloud como parte de un contrato con Google Cloud.

Puedes usar la API de precios para obtener una lista de servicios o el precio de una unidad de mantenimiento de existencias (SKU) específica. Un SKU identifica de forma clara un recurso que puedes comprar. Un ejemplo de un SKU es Nvidia Tesla T4 GPU attached to Spot Preemptible VMs running in Warsaw. Si tienes un contrato con precios personalizados, también puedes usar la API de precios para obtener los precios personalizados asociados con tu cuenta de Facturación de Cloud.

Para obtener una lista completa de los recursos disponibles en la API de precios y, para obtener información detallada sobre los formatos de solicitud y respuesta, consulta la referencia de la API.

Antes de comenzar

Enable the Cloud Billing API.

Enable the API

Obtén información pública sobre precios y servicios

En los siguientes ejemplos, se muestran llamadas a la API que puedes usar para obtener información enumerada de forma pública sobre los servicios de Google Cloud y los SKU.

Para obtener información sobre servicios públicos, SKU o precios, debes crear una clave de API.

Obtén una lista de los servicios públicos de Google Cloud

En el siguiente ejemplo, se enumeran todos los servicios públicos de Google Cloud, incluidos los metadatos de cada servicio.

No necesitas ningún permiso de IAM específico para realizar esta llamada a la API.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • API_KEY: Es la clave de API de Google Cloud.
  • PAGE_SIZE (Opcional): La cantidad de servicios que se mostrarán. El valor predeterminado es 50.
  • PAGE_TOKEN (Opcional): El token de página, que obtienes del nextPageToken en una respuesta anterior.

Método HTTP y URL:

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el siguiente comando:

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

PowerShell

Ejecuta el siguiente 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 respuesta contiene una lista de servicios y la información sobre cada servicio. En el siguiente ejemplo, se muestra el formato de Compute Engine.

Los resultados se paginan y se limitan a 50 servicios por página. La respuesta incluye un nextPageToken que puedes usar para obtener la siguiente página de resultados. Para recuperar el siguiente lote, establece pageToken=PAGE_TOKEN. Para reducir la cantidad de SKU por página, establece pageSize=PAGE_SIZE. Cuando se enumeran todos los elementos, no se muestra ningún token.

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

Obtén una lista de SKU para un servicio público de Google Cloud

En el siguiente ejemplo, se enumeran los SKU públicos de un servicio específico.

No necesitas ningún permiso de IAM específico para realizar esta llamada a la API.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • API_KEY: Es la clave de API de Google Cloud.
  • FILTER: Los servicios por los que se filtran los SKU. Por ejemplo, para enumerar los SKU de Compute Engine, usa el filtro service="services/6F81-5844-456A".
  • PAGE_SIZE (Opcional): Es la cantidad máxima de SKU que se mostrarán. El valor predeterminado es 50 y el máximo es 5000.
  • PAGE_TOKEN (Opcional): El token de la página, que está en nextPageToken en la respuesta.

Método HTTP y URL:

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el siguiente comando:

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

PowerShell

Ejecuta el siguiente 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
En la siguiente respuesta, se presentan algunos SKU de ejemplo que se muestran para Compute Engine. Los resultados se paginan y se limitan a 50 SKUs por página. La respuesta incluye un nextPageToken que puedes usar para obtener la siguiente página de resultados. Para recuperar el siguiente lote, establece pageToken=PAGE_TOKEN. Para cambiar la cantidad de SKU por página, establece pageSize=PAGE_SIZE. Cuando se enumeran todos los elementos, no se muestra ningún 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"
}

Obtén los precios de todos los SKU públicos de Google Cloud

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • SKU_ID: Es un ID de SKU específico para el que se obtiene el precio. Para obtener precios de todos los SKU, usa “-”.
  • API_KEY: Es la clave de API de Google Cloud.
  • PAGE_SIZE (Opcional): La cantidad de servicios que se mostrarán. El valor predeterminado es 50.
  • PAGE_TOKEN (Opcional): El token de página, que obtienes del nextPageToken en una respuesta anterior.

Método HTTP y URL:

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el siguiente comando:

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

PowerShell

Ejecuta el siguiente 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 respuesta contiene información de precios para cada ID del SKU. En el siguiente ejemplo, se muestra el formato de todos los SKU públicos, con un tamaño de página de “2”.

Los resultados se paginan y, de forma predeterminada, contienen 50 precios por página. La respuesta incluye un nextPageToken que puedes usar para obtener la siguiente página de resultados. Para recuperar el siguiente lote, establece pageToken=PAGE_TOKEN. Para reducir la cantidad de resultados por página, establece pageSize=PAGE_SIZE. Cuando se enumeran todos los elementos, no se muestra ningún 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"
}

Obtén el precio de un SKU público

En el siguiente ejemplo, se obtiene el precio de un SKU que aparece de forma pública. Puedes obtener una lista completa de los IDs de SKU de Google Cloud en la página de SKU.

No necesitas ningún permiso de IAM específico para realizar esta llamada a la API.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • API_KEY: Es la clave de API de Google Cloud.
  • SKU_ID: Es el identificador de SKU, que puedes obtener mediante el método skus.list. El ID es la string que aparece después del identificador skus/.
  • CURRENCY: (Opcional) Es el código de moneda ISO-4217 para el precio. Si no se especifica, el precio está en la misma moneda que tu cuenta de Facturación de Cloud.

Método HTTP y URL:

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el siguiente comando:

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

PowerShell

Ejecuta el siguiente 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
En el siguiente ejemplo, se muestran los detalles de precios para el ID de 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"
    }
  }
}

Obtén información específica de tu cuenta de Facturación de Cloud

En los siguientes ejemplos, se muestran las llamadas a la API que obtienen información específica de tu cuenta de Facturación de Cloud, como SKU específicos o información de precios que podría ser parte de tu contrato de precios personalizado.

Según el recurso de API que uses, debes tener estos permisos para la cuenta de Facturación de Cloud:

  • Para obtener información sobre los servicios mediante billingAccounts.services, necesitas lo siguiente:

    • billing.billingAccountServices.get
    • billing.billingAccountServices.list
  • Para obtener información sobre los SKU a través de billingAccounts.skus, necesitas lo siguiente:

    • billing.billingAccountSkus.get
    • billing.billingAccountSkus.list
  • Para obtener información sobre los grupos de SKU mediante billingAccounts.skugroups, necesitas lo siguiente:

    • billing.billingAccountSkuGroups.get
    • billing.billingAccountSkuGroups.list
  • Para obtener información sobre los SKU que forman parte de los grupos de SKU con billingAccounts.skugroups.skus, necesitas lo siguiente:

    • billing.billingAccountSkuGroupSkus.get
    • billing.billingAccountSkuGroupSkus.list
  • Para obtener información sobre los precios de los SKU con billingAccounts.skus.price, necesitas lo siguiente:

    • billing.billingAccountPrice.get

Si llamas a la API con una cuenta de servicio, esta debe tener los permisos.

Los siguientes roles predefinidos tienen los permisos para obtener información específica de tu cuenta de Facturación de Cloud:

  • Administrador de cuentas de facturación
  • Visualizador de cuentas de facturación

Obtén una lista de grupos de SKU para tu cuenta de Facturación de Cloud

Si tienes un contrato de precios con Google Cloud, tu contrato puede referirse a grupos de SKU, que contienen SKU que pertenecen a una categoría específica. Por ejemplo, el grupo de SKU de BigQuery contiene SKU para el análisis y el almacenamiento de BigQuery en varias ubicaciones.

En el siguiente ejemplo, se enumeran los grupos de SKU que están disponibles para tu cuenta de Facturación de Cloud.

Para realizar esta llamada a la API, necesitas el permiso billing.billingAccountSkuGroups.list de IAM en tu cuenta de Facturación de Cloud.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • BILLING_ACCOUNT_ID: El ID de la cuenta de facturación de Cloud
  • PAGE_SIZE (Opcional): Es la cantidad máxima de grupos de SKU que se mostrarán. El valor predeterminado es 50 y el máximo es 5000.
  • PAGE_TOKEN (Opcional): El token de la página, que está en nextPageToken en la respuesta.

Método HTTP y URL:

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el siguiente 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

Ejecuta el siguiente 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 respuesta es una lista de grupos de SKU, en el formato que se muestra a continuación.

Los resultados se paginan y se limitan a 50 grupos de SKU por página. La respuesta incluye un nextPageToken que puedes usar para obtener la siguiente página de resultados. Para recuperar el siguiente lote, establece pageToken=PAGE_TOKEN. Para reducir la cantidad de SKU por página, establece pageSize=PAGE_SIZE. Cuando se enumeran todos los elementos, no se muestra ningún 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"
}

Obtén una lista de SKU en un grupo de SKU para tu cuenta de Facturación de Cloud

En el siguiente ejemplo, se enumeran los SKU de un grupo de SKU que podría ser parte de tu contrato de precios personalizado.

Para realizar esta llamada a la API, necesitas el permiso billing.billingAccountSkuGroupSkus.list de IAM en tu cuenta de Facturación de Cloud.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • SKU_GROUP_ID: Es el ID del grupo de SKU, que obtienes de billingAccount.skuGroups.list method.
  • BILLING_ACCOUNT_ID: El ID de la cuenta de facturación de Cloud
  • PAGE_SIZE (Opcional): Es la cantidad de grupos de SKU que se obtendrán. El valor predeterminado es 5000.
  • PAGE_TOKEN (Opcional): El token de la página, que está en nextPageToken en la respuesta.

Método HTTP y URL:

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el siguiente 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

Ejecuta el siguiente 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

En el siguiente ejemplo, se muestran los primeros 2 SKUs para el grupo de SKU Network Data Transfer, con el ID 28934b47-792e-4afa-a025-7720d410482f.

Los resultados se paginan y se limitan a 5000 grupos de SKU por página. La respuesta incluye un nextPageToken que puedes usar para obtener la siguiente página de resultados. Para recuperar el siguiente lote, establece pageToken=PAGE_TOKEN. Para reducir la cantidad de SKU por página, establece pageSize=PAGE_SIZE. Cuando se enumeran todos los elementos, no se muestra ningún 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"
}

Obtén los precios de todos los SKU de Google Cloud para tu cuenta de Facturación de Cloud

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • SKU_ID: Es un ID de SKU específico para el que se obtiene el precio. Para obtener precios de todos los SKU, usa “-”.
  • API_KEY: Es la clave de API de Google Cloud.
  • PAGE_SIZE (Opcional): La cantidad de servicios que se mostrarán. El valor predeterminado es 50.
  • PAGE_TOKEN (Opcional): El token de página, que obtienes del nextPageToken en una respuesta anterior.

Método HTTP y URL:

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el siguiente 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

Ejecuta el siguiente 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 respuesta contiene una lista de IDs de SKU y sus precios, incluidos los SKU que solo están disponibles para tu cuenta de Facturación de Cloud y la información de precios para cada SKU. En el siguiente ejemplo, se muestra el formato de todos los SKU, con un tamaño de página de “2”.

Los resultados se paginan y, de forma predeterminada, contienen 50 precios por página. La respuesta incluye un nextPageToken que puedes usar para obtener la siguiente página de resultados. Para recuperar el siguiente lote, establece pageToken=PAGE_TOKEN. Para cambiar la cantidad de SKU por página, establece pageSize=PAGE_SIZE. Cuando se enumeran todos los elementos, no se muestra ningún 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"
}

Obtén los precios de los SKU para tu cuenta de Facturación de Cloud

En el siguiente ejemplo, se indica el precio que pagas por un SKU. Si el SKU forma parte de un contrato de precio personalizado, la respuesta incluye información sobre el descuento en el precio de lista.

Para realizar esta llamada a la API, necesitas el permiso billing.billingAccountPrice.get de IAM en tu cuenta de Facturación de Cloud.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • SKU_ID: Es el identificador de SKU, que puedes obtener mediante el método billingAccounts.skus. El ID es la string que aparece después del identificador skus/.
  • BILLING_ACCOUNT_ID: El ID de la cuenta de facturación de Cloud
  • CURRENCY: (Opcional) Es el código de moneda ISO-4217 para el precio. Si no se especifica, el precio está en la misma moneda que tu cuenta de Facturación de Cloud.

Método HTTP y URL:

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el siguiente 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

Ejecuta el siguiente 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 respuesta contiene detalles sobre cómo se te cobra por el SKU en el objeto priceReason. En el siguiente ejemplo, se muestran los detalles de precios para el ID de SKU 0012-B7F2-DD14. En este ejemplo, la cuenta de Facturación de Cloud tiene un contrato de precios, pero paga el precio de lista de este 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": {}
  }
}