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 Selector de proyectos de Cloud Console, selecciona o crea un proyecto de Cloud.

    Ir a la página 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. Configurar la autenticación
    1. En Cloud Console, ve a la página Crear clave de la cuenta de servicio.

      Ir a la página Crear 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.

      Nota: El campo Función autoriza tu cuenta de servicio para acceder a los recursos. Puedes ver y cambiar este campo más adelante con Cloud Console. Si desarrollas una app de producción, especifica permisos más detallados que Proyecto > Propietario. Para obtener más información, consulta Cómo otorgar funciones a las cuentas de servicio.
    5. Haz clic en Crear. Se descargará un archivo JSON a tu computadora que contiene tus descargas de claves.
  6. Configura la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta de acceso al archivo JSON que contiene la clave de la cuenta de servicio. Esta variable solo se aplica a tu 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 la página Administrar recursos

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