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

La API de Google Cloud Pricing 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 Pricing para obtener una lista de servicios o el precio de una unidad de almacenamiento (SKU) específica. Un SKU identifica de forma clara un recurso que puedes comprar. Un ejemplo de 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 a tu cuenta de Facturación de Cloud.

Para obtener una lista completa de los recursos disponibles en la API de Precios y ver 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

Las APIs están habilitadas en un Google Cloud proyecto. La API de Precios forma parte de la API de Cloud Billing. Cuando se te solicite que confirmes el proyecto que deseas usar para la API de Precios, te recomendamos que uses un proyectoGoogle Cloud configurado para contener todas tus necesidades de FinOps y administración de facturación para una cuenta de Facturación de Cloud. Este proyecto puede contener todas las APIs específicas de facturación, incluida la API de Cloud Billing.

Obtén más información sobre los beneficios de usar un proyecto enfocado en FinOps para tus casos de uso de administración de facturación.

Obtén información sobre los precios y los servicios públicos

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

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

Obtener una lista de los servicios Google Cloud públicos

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

No necesitas permisos de IAM específicos 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: Tu clave de API de Google Cloud .
  • PAGE_SIZE (opcional): Es la cantidad de servicios que se devolverá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 uno de ellos. En el siguiente ejemplo, se muestra el formato para 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 los SKU de un servicio Google Cloud público

En el siguiente ejemplo, se enumeran los SKUs públicos de un servicio especificado.

No necesitas permisos de IAM específicos 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: Tu clave de API de Google Cloud .
  • FILTER: Son 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 muestran algunos ejemplos de SKU que se devolvieron 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 Google Cloud SKU públicos

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: Tu clave de API de Google Cloud .
  • PAGE_SIZE (opcional): Es la cantidad de servicios que se devolverá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 se muestra públicamente. Puedes obtener una lista completa de los IDs de Google Cloud SKU en la página de SKU.

No necesitas permisos de IAM específicos 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: Tu clave de API de Google Cloud .
  • SKU_ID: Es el identificador del SKU, que puedes obtener con el método skus.list. El ID es la cadena después del identificador skus/.
  • CURRENCY: (Opcional) Es el código de moneda ISO-4217 para el precio. Si no se especifica, el precio se expresa 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 sobre 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 SKU específicos o información de precios que podría formar parte de tu contrato de precios personalizados.

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

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

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

    • billing.billingAccountSkus.get
    • billing.billingAccountSkus.list
  • Para obtener información sobre los grupos de SKU con 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 los grupos de SKU para tu cuenta de Facturación de Cloud

Si tienes un contrato de precios con Google Cloud, es posible que este haga referencia 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 disponibles para tu cuenta de Facturación de Cloud.

Para realizar esta llamada a la API, necesitas el permiso de IAM billing.billingAccountSkuGroups.list 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 tu 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 los SKU de 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ían formar parte de tu contrato de precios personalizados.

Para realizar esta llamada a la API, necesitas el permiso de IAM billing.billingAccountSkuGroupSkus.list 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 tu 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 Google Cloud SKU 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: Tu clave de API de Google Cloud .
  • PAGE_SIZE (opcional): Es la cantidad de servicios que se devolverá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 obtiene el precio que pagas por un SKU. Si el SKU forma parte de un contrato de precios personalizados, la respuesta incluye información sobre el descuento en el precio de lista.

Para realizar esta llamada a la API, necesitas el permiso de IAM billing.billingAccountPrice.get 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 del SKU, que puedes obtener con el método billingAccounts.skus. El ID es la cadena después del identificador skus/.
  • BILLING_ACCOUNT_ID: El ID de tu 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 se expresa 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 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": {}
  }
}