> ## Documentation Index
> Fetch the complete documentation index at: https://docs.optimazehq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Cloud

> Connect Google Cloud Detailed billing export in BigQuery so Optimaze can ingest Google Cloud cost data.

Connect Google Cloud billing to Optimaze using **Detailed** Cloud Billing export to BigQuery. Optimaze provisions a dedicated reader service account; you grant it read access in your Google Cloud project.

## Prerequisites

* A Google Cloud billing account with **Detailed** (resource-level) export to BigQuery enabled, not Standard-only
* BigQuery export project ID and dataset ID for that billing account
* Permission to grant IAM roles in the export project (`BigQuery Job User` on the project, `BigQuery Data Viewer` on the dataset)

## Set up the Google Cloud integration

In Optimaze, open **Integrations**, then choose **Google Cloud** (or **Create** and select Google Cloud).

### Step 1: Enter BigQuery billing details

Provide:

* **Billing Account ID** (for example `012345-6789AB-CDEF01`)
* **BigQuery Project ID**
* **BigQuery Dataset ID**

Optimaze uses these to locate your Detailed billing export tables.

![Image](https://mintcdn.com/optimaze/H22rTqPFmthmkajv/images/image-20.png?fit=max\&auto=format\&n=H22rTqPFmthmkajv\&q=85\&s=0ab9cd4a997260528812c7e1a1d4da23)

### Step 2: Create the integration

Submit the form. Optimaze validates the configuration shape and provisions a dedicated reader service account for this integration.

![Image](https://mintcdn.com/optimaze/H22rTqPFmthmkajv/images/image-22.png?fit=max\&auto=format\&n=H22rTqPFmthmkajv\&q=85\&s=4179bd9fd6ac190223961a800a9c979e)

### Step 3: Grant IAM in Google Cloud

When prompted, grant these roles to the **service account email** shown in Optimaze:

| Role | Scope |
| :- | :- |
| **BigQuery Job User** | On the export **project** |
| **BigQuery Data Viewer** | On the export **dataset** |

Use the link to open the Google Cloud IAM console for the project, add the service account as a principal, and assign the roles above.

![Gcp](https://mintcdn.com/optimaze/H22rTqPFmthmkajv/images/gcp.png?fit=max\&auto=format\&n=H22rTqPFmthmkajv\&q=85\&s=292144a49af0f73f609dc3aa054785b0)

### Step 4: Checking setup

Optimaze verifies that it can authenticate, run BigQuery jobs, and read Detailed export data. Fix any errors (wrong dataset, Standard-only export, or missing IAM) and retry until validation succeeds.

![Screenshot 2026 07 14 At 4 43 11 Pm](https://mintcdn.com/optimaze/H22rTqPFmthmkajv/images/Screenshot-2026-07-14-at-4.43.11-pm.png?fit=max\&auto=format\&n=H22rTqPFmthmkajv\&q=85\&s=0826bb2c107083074aae311fc121c079)

## What happens next

Once validation succeeds, Optimaze syncs billing periods from your BigQuery export into the platform for attribution and FinOps reporting. Monitor health and last sync on the Integrations list.

## Data flow (summary)

Customer **Detailed** billing export in BigQuery → Optimaze reader service account (IAM you grant) → Optimaze internal storage and analytics. Optimaze does not require access to your application code or production workloads.

## Troubleshooting

* **Standard-only export:** Enable **Detailed** export for the billing account in the Google Cloud console.
* **IAM denied:** Confirm Job User on the project and Data Viewer on the dataset for the Optimaze service account email.
* **Wrong dataset / billing account:** Re-check billing account ID, project ID, and dataset ID match the export you configured.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.