Obtener información sobre los precios de Google Cloud

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

En esta página se muestran algunos ejemplos de solicitudes de API que puedes hacer para obtener información sobre servicios y SKUs públicos, así como sobre servicios y SKUs 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 Pricing para obtener una lista de servicios o el precio de una unidad de mantenimiento de stock (SKU) específica. Un SKU identifica de forma inequívoca un recurso que puedes comprar. Por ejemplo, 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 Pricing para obtener los precios personalizados asociados a tu cuenta de Facturación de Cloud.

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

Antes de empezar

Enable the Cloud Billing API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Las APIs se habilitan en un Google Cloud proyecto. La API Pricing forma parte de la API Cloud Billing. Cuando se te pida que confirmes el proyecto que quieres usar para la API Pricing, te recomendamos que uses unGoogle Cloud proyecto configurado para cubrir todas tus necesidades de FinOps y de administración de la facturación de una cuenta de facturación de Cloud. Este proyecto puede contener todas las APIs específicas de facturación, incluida la API Cloud Billing.

Consulta más información sobre las ventajas de usar un proyecto centrado en FinOps en tus casos prácticos de administración de facturación.

Obtener información sobre los servicios públicos y los precios

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

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

Obtener una lista de servicios públicos Google Cloud

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

No necesitas ningún permiso de gestión de identidades y accesos específico para hacer esta llamada a la API.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • API_KEY: tu clave de API. Google Cloud
  • PAGE_SIZE (Opcional): número de servicios que se van a devolver. El valor predeterminado es 50.
  • PAGE_TOKEN (Opcional): El token de página, que se obtiene 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 comando siguiente: 

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

PowerShell

Ejecuta el comando siguiente: 

$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 e información sobre cada uno de ellos. En el ejemplo siguiente 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 obtener el siguiente lote, define pageToken=PAGE_TOKEN. Para reducir el número de SKUs por página, defina pageSize=PAGE_SIZE. Cuando se hayan incluido todos los elementos, no se devolverá ningún token. 

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

Obtener una lista de SKUs de un servicio público Google Cloud

En el siguiente ejemplo se muestran los SKUs públicos de un servicio concreto.

No necesitas ningún permiso de gestión de identidades y accesos específico para hacer esta llamada a la API.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • API_KEY: tu clave de API. Google Cloud
  • FILTER: los servicios por los que se filtrarán los SKUs. Por ejemplo, para enumerar los SKUs de Compute Engine, usa el filtro service="services/6F81-5844-456A".
  • PAGE_SIZE (Opcional): número máximo de SKUs que se van a devolver. El valor predeterminado es 50 y el máximo es 5000.
  • PAGE_TOKEN (Opcional): el token de página, que se encuentra 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 comando siguiente: 

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

PowerShell

Ejecuta el comando siguiente: 

$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 muestran algunos ejemplos de SKUs devueltos de 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 obtener el siguiente lote, define pageToken=PAGE_TOKEN. Para cambiar el número de SKUs por página, define pageSize=PAGE_SIZE. Cuando se hayan enumerado todos los elementos, no se devolverá 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"
}

Obtener los precios de todos los Google Cloud SKUs públicos

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • SKU_ID: ID de SKU específico para obtener el precio. Para obtener los precios de todos los SKUs, usa "-".
  • API_KEY: tu clave de API. Google Cloud
  • PAGE_SIZE (Opcional): número de servicios que se van a devolver. El valor predeterminado es 50.
  • PAGE_TOKEN (Opcional): El token de página, que se obtiene 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 comando siguiente: 

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

PowerShell

Ejecuta el comando siguiente: 

$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 sobre los precios de cada ID de SKU.En el ejemplo siguiente se muestra el formato de todos los SKUs 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 obtener el siguiente lote, define pageToken=PAGE_TOKEN. Para reducir el número de resultados por página, define pageSize=PAGE_SIZE. Cuando se hayan incluido todos los elementos, no se devolverá 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"
}

Obtener el precio de un SKU público

En el siguiente ejemplo se obtiene el precio de un SKU público. Puedes consultar la lista completa de IDs de SKU en la página SKUs Google Cloud .

No necesitas ningún permiso de gestión de identidades y accesos específico para hacer esta llamada a la API.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • API_KEY: tu clave de API. Google Cloud
  • SKU_ID: el identificador de SKU, que puedes obtener con el método skus.list. El ID es la cadena que aparece después del identificador skus/.
  • CURRENCY: (opcional) código de moneda ISO 4217 del precio. Si no se especifica, el precio se indica en la misma moneda que la de 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 comando siguiente: 

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

PowerShell

Ejecuta el comando siguiente: 

$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 los precios del 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"
    }
  }
}

Obtener información específica de tu cuenta de facturación de Cloud

En los siguientes ejemplos se muestran llamadas a la API que obtienen información específica de tu cuenta de Facturación de Cloud, como SKUs concretos o información sobre precios que puede formar parte de tu contrato de precios personalizado.

En función del recurso de la API que utilices, debes tener estos permisos en 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 SKUs mediante billingAccounts.skus, necesitas lo siguiente:

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

  • Para obtener información sobre los grupos de SKUs mediante billingAccounts.skugroups, necesitas lo siguiente:

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

  • Para obtener información sobre los SKUs que forman parte de grupos de SKUs mediante billingAccounts.skugroups.skus, necesitas lo siguiente:

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

  • Para obtener información sobre los precios de los SKUs mediante 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 cuenta de facturación
  • Lector de cuenta de facturación

Obtener una lista de grupos de SKUs de tu cuenta de facturación de Cloud

Si tienes un contrato de precios con Google Cloud, es posible que en él se haga referencia a grupos de SKUs, que contienen SKUs que pertenecen a una categoría específica. Por ejemplo, el grupo de SKUs de BigQuery contiene SKUs de análisis y almacenamiento de BigQuery en varias ubicaciones.

En el siguiente ejemplo se muestran los grupos de SKUs que están disponibles en tu cuenta de facturación de Cloud.

Para hacer esta llamada a la API, necesitas el billing.billingAccountSkuGroups.list permiso de gestión de identidades y accesos en tu cuenta de facturación de Cloud.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • BILLING_ACCOUNT_ID: tu ID de cuenta de facturación de Cloud.
  • PAGE_SIZE (Opcional): Número máximo de grupos de SKUs que se devolverán. El valor predeterminado es 50 y el máximo es 5000.
  • PAGE_TOKEN (Opcional): el token de página, que se encuentra 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 comando siguiente: 

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 comando siguiente: 

$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 SKUs con el formato que se muestra a continuación.

Los resultados se paginan y se limitan a 50 grupos de SKUs por página. La respuesta incluye un nextPageToken que puedes usar para obtener la siguiente página de resultados. Para obtener el siguiente lote, define pageToken=PAGE_TOKEN. Para reducir el número de SKUs por página, defina pageSize=PAGE_SIZE. Cuando se hayan incluido todos los elementos, no se devolverá 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"
}

Obtener una lista de SKUs de un grupo de SKUs de tu cuenta de facturación de Cloud

En el siguiente ejemplo se muestran los SKUs de un grupo de SKUs que podrían formar parte de tu contrato de precios personalizado.

Para hacer esta llamada a la API, necesitas el billing.billingAccountSkuGroupSkus.list permiso de gestión de identidades y accesos en tu cuenta de facturación de Cloud.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • SKU_GROUP_ID: el ID del grupo de SKUs, que se obtiene de billingAccount.skuGroups.list method.
  • BILLING_ACCOUNT_ID: tu ID de cuenta de facturación de Cloud.
  • PAGE_SIZE (Opcional): Número de grupos de SKUs que se van a obtener. El valor predeterminado es 5000.
  • PAGE_TOKEN (Opcional): el token de página, que se encuentra 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 comando siguiente: 

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 comando siguiente: 

$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 dos primeros SKUs del grupo de SKUs Network Data Transfer, con el ID 28934b47-792e-4afa-a025-7720d410482f.

Los resultados se paginan y se limitan a 5000 grupos de SKUs por página. La respuesta incluye un nextPageToken que puedes usar para obtener la siguiente página de resultados. Para obtener el siguiente lote, define pageToken=PAGE_TOKEN. Para reducir el número de SKUs por página, defina pageSize=PAGE_SIZE. Cuando se hayan incluido todos los elementos, no se devolverá 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"
}

Obtener los precios de todos los Google Cloud SKUs de tu cuenta de Facturación de Cloud

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • SKU_ID: ID de SKU específico para obtener el precio. Para obtener los precios de todos los SKUs, usa "-".
  • API_KEY: tu clave de API. Google Cloud
  • PAGE_SIZE (Opcional): número de servicios que se van a devolver. El valor predeterminado es 50.
  • PAGE_TOKEN (Opcional): El token de página, que se obtiene 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 comando siguiente: 

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 comando siguiente: 

$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 SKUs que solo están disponibles para tu cuenta de Facturación de Cloud, así como información sobre los precios de cada SKU. En el ejemplo siguiente se muestra el formato de todos los SKUs, 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 obtener el siguiente lote, define pageToken=PAGE_TOKEN. Para cambiar el número de resultados por página, define pageSize=PAGE_SIZE. Cuando se hayan incluido todos los elementos, no se devolverá 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"
}

Obtener los precios de los SKUs de tu cuenta de facturación de Cloud

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

Para hacer esta llamada a la API, necesitas el billing.billingAccountPrice.get permiso de gestión de identidades y accesos en tu cuenta de facturación de Cloud.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • SKU_ID: el identificador de SKU, que puedes obtener con el método billingAccounts.skus. El ID es la cadena que aparece después del identificador skus/.
  • BILLING_ACCOUNT_ID: tu ID de cuenta de facturación de Cloud.
  • CURRENCY: (opcional) código de moneda ISO 4217 del precio. Si no se especifica, el precio se indica en la misma moneda que la de 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 comando siguiente: 

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 comando siguiente: 

$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 información sobre cómo se te cobra el SKU en el objeto priceReason. En el siguiente ejemplo se muestran los detalles de los precios del 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 según catálogo 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": {}
  }
}