Skip to content

Google Cloud (GCP)

Connect one or more GCP projects or a GCP Organization to bring billing, resource inventory, and commitment data into CloudVerse AI.

What you get

  • Billing data from GCP BigQuery billing export
  • Resource inventory across projects, regions, and services
  • Committed Use Discount (CUD) coverage and recommendations
  • Anomaly detection and budget tracking per project or organization

Prerequisites

  • GCP project with billing enabled
  • BigQuery billing export configured (standard or detailed)
  • Service account with the required IAM roles

Connect GCP

  1. Go to Settings > Integrations.
  2. Select Google Cloud.
  3. Enter a connection name — for example, gcp-production.
  4. Complete the Billing Setup step:
    • Confirm your BigQuery billing export dataset and project.
    • Enter the billing account ID.
  5. Complete the Authentication step:
    • Create a GCP service account.
    • Grant the required IAM roles.
    • Download and upload the service account JSON key.
  6. Select the projects or organization scope to include in discovery.
  7. Finish the flow and wait for initial data ingestion.

Verify the connection

  1. Open the GCP connection detail page in Settings > Integrations.
  2. Confirm that billing and discovery status indicators are green.
  3. Open Cost Management > Cost Explorer, filter by Provider: GCP, and confirm data appears.
  4. Open Cloud Infrastructure > Resources and filter by your GCP project to verify inventory.

Permissions required

The GCP service account needs:

  • roles/bigquery.dataViewer on the BigQuery billing export dataset
  • roles/bigquery.jobUser on the project running the BigQuery jobs
  • roles/viewer at the project or organization scope (for resource inventory)
  • roles/billing.viewer at the billing account scope

Best practices

  • Enable detailed billing export in BigQuery for full resource-level cost data.
  • Connect at the organization level to pull all projects automatically.
  • Rotate service account keys on schedule and update them in CloudVerse immediately after.

Troubleshooting

  • No billing data — Check that BigQuery export is enabled and that the service account has bigquery.dataViewer on the correct dataset.
  • Missing projects — Verify the service account has viewer at the organization or folder level.
  • Authentication failure — Ensure the service account JSON key is valid and not expired.

See Integration setup issues for more help.