Back to docs
Account connection guide

GCP billing export access guide

Use a service account that can query an existing BigQuery billing export table.

Minimum access
BigQuery query access

Before you connect

Enable BigQuery billing export for the billing account before connecting Rateplane.
Use a dedicated service account key for billing reads.
Grant access to the BigQuery dataset and table that hold the billing export.
Confirm the project ID, dataset, and table names are correct before testing.

Setup steps

  1. 1.Enable standard or detailed billing export to BigQuery.
  2. 2.Create a dedicated service account for Rateplane.
  3. 3.Grant the service account query access to the billing export dataset.
  4. 4.Generate a JSON key for that service account.
  5. 5.Paste the project ID, key JSON, dataset, and table into Rateplane.
  6. 6.Run the in-app connection test before saving the account.

How to verify it worked

The connection test should report that the BigQuery billing export can be queried.
The first sync should import spend records from the configured table.
If the test fails, verify dataset permissions and the exact table name.
GCP billing export access guide — Rateplane