Enviar peticiones

En este tema se explica cómo enviar varias peticiones sencillas a la API Cloud Billing de Google.

Para ver una lista completa de métodos, consulta la documentación de referencia de REST o RPC.

Antes de empezar

  1. Accede a tu Cuenta de Google.

    Si todavía no tienes una cuenta, regístrate para obtener una nueva.

  2. En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir a la página del selector de proyectos

  3. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

  4. Habilita las Cloud Billing API.

    Habilita la API

  5. Configura la autenticación
    1. En Cloud Console, ve a la página Crea una clave de cuenta de servicio.

      Ir a la página Crea una clave de la cuenta de servicio
    2. En la lista Cuenta de servicio, selecciona Cuenta de servicio nueva.
    3. Ingresa un nombre en el campo Nombre de cuenta de servicio.
    4. En la lista Función, selecciona Proyecto > Propietario.

    5. Haz clic en Crear. Se descargará un archivo JSON que contiene tus claves a tu computadora.
  6. Configura la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta del archivo JSON que contiene la clave de tu cuenta de servicio. Esta variable solo se aplica a la sesión actual de shell. Por lo tanto, si abres una sesión nueva, deberás volver a configurar la variable.

Obtener una lista de cuentas de facturación

El método de la API para mostrar todas las cuentas de facturación (de REST o RPC) es el más sencillo de la API, ya que no requiere parámetros. Por esa razón, es un buen punto de partida. El método simplemente devuelve todas las cuentas de facturación que tienes permiso para ver.

Protocolo

GET https://cloudbilling.googleapis.com/v1/billingAccounts

Java

    ListBillingAccountsResponse result = service.billingAccounts().list().execute();

Recuperar una cuenta de facturación concreta

Para recuperar una cuenta de facturación concreta (de REST o RPC), primero necesitas saber su ID. En este ejemplo, se utilizará el ID de ejemplo 012345-567890-ABCDEF.

Protocolo

GET https://cloudbilling.googleapis.com/v1/billingAccounts/012345-567890-ABCDEF

Java

    BillingAccount result = service.billingAccounts()
        .get("billingAccounts/00C5EA-61187E-D842F2").execute();

Habilitar la facturación en un proyecto

Para habilitar la facturación en un proyecto, debes llamar a la API para que asocie el proyecto a una cuenta de facturación (de REST o RPC). En el siguiente código de ejemplo, se asocia el proyecto tokyo-rain-123 con la cuenta de facturación 012345-567890-ABCDEF. Dicho sea de paso, puedes configurar billingAccountName como vacío para usar el mismo método de API para inhabilitar la facturación.

Protocolo

PUT https://cloudbilling.googleapis.com/v1/projects/tokyo-rain-123/billingInfo

{
  "billingAccountName": "billingAccounts/012345-567890-ABCDEF"
}

Java

    service.projects().updateBillingInfo(
            "projects/tokyo-rain-123",
            new ProjectBillingInfo().setBillingAccountName("billingAccounts/012345-567890-ABCDEF"))
        .execute();

Limpieza

  1. En Cloud Console, ve a la página Administrar recursos.

    Ir a Administrar recursos

  2. En la lista de proyectos, elige el proyecto que quieres borrar y haz clic en Borrar.
  3. En el diálogo, escribe el ID del proyecto y, luego, haz clic en Cerrar para borrar el proyecto.