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 ayudan 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 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 Pricing 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

Las APIs están habilitadas en un proyecto de Google Cloud. 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 Pricing, te recomendamos que uses un proyecto de Google Cloud configurado para contener todas tus necesidades de FinOps y administración de 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 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 servicios públicos y los precios

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

Para obtener información sobre los servicios públicos, los SKU o los 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 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: Es la clave de API de Google Cloud.
  • PAGE_SIZE (opcional): Es 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 uno de ellos. 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 los SKUs de un servicio público de Google Cloud

En el siguiente ejemplo, se enumeran los SKU 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: Es la clave de API de Google Cloud.
  • FILTER: Son los servicios por los que se filtrarán los SKU. Por ejemplo, para mostrar una lista de los SKU de Compute Engine, usa el filtro service="services/6F81-5844-456A".
  • PAGE_SIZE (opcional): Es la cantidad máxima de SKUs 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 SKUs 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): Es 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 se muestra públicamente. Puedes obtener una lista completa de los IDs de SKU de Google Cloud 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: Es la clave de API de Google Cloud.
  • SKU_ID: Es el identificador de 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 muestra 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 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 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"
    }
  }
}

Obtén 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 específicos o información de precios que podría ser 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 de tu cuenta de Facturación de Cloud

Si tienes un contrato de precios con Google Cloud, es posible que se haga referencia a los grupos de SKU, que contienen SKU que pertenecen a una categoría específica. Por ejemplo, el grupo de SKUs de BigQuery contiene SKUs 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 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 SKUs de un grupo de SKU que podrían ser 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 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): Es 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 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 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 de 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 muestra 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 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 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 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": {}
  }
}