Docs / Workflows / Integrations / Google Analytics
Google Analytics
Read GA4 property settings and traffic, page, key-event and realtime reports.
What you can do
Each Google Analytics integration’s page in OAIZ shows these uses, with its events and its read and write actions, under What you can do with Google Analytics.
- Weekly traffic report
- Send your team a weekly traffic report.
- Sign-up comparison
- Compare this week’s sign-ups with last week’s and flag drops.
- Realtime visitors
- Watch realtime visitors during a campaign launch.
Connection scope
The connected Google account determines the GA4 properties available. Reports take a canonical property name, such as properties/123456. Dimensions group the results and metrics provide the measured values. Property metadata identifies the fields valid for that property.
Connecting
Google Analytics connections must be enabled for your OAIZ organization before you can connect or reauthorize this service. Choose Google Analytics in OAIZ and authorize the Google account whose resources the workflows should use. If this service is being added to an existing Google connection, use the same Google account.
The Google account must already have access to the GA4 properties the workflows will read.
Google permissions
OAuth scopes are the permissions OAIZ requests from Google. Each connection asks for account identity and the permissions for its selected service. Adding another Google service requests its additional permissions on the same account. Google’s consent screen shows the exact access before you approve.
openid
https://www.googleapis.com/auth/userinfo.email
https://www.googleapis.com/auth/analytics.readonly- openid
- Identify the Google account that owns the shared connection.
- userinfo.email
- Show the connected Google account’s email address in OAIZ.
- analytics.readonly
- Read accessible Analytics accounts, GA4 property configuration and report data. OAIZ does not change Analytics settings.
Read actions
- List Properties
- List accessible Analytics accounts and their GA4 property IDs and names.
- Get Property
- Read a GA4 property’s configuration.
- List Data Streams
- List one page of web or app data streams for a GA4 property.
- List Custom Dimensions
- List one page of custom dimension definitions for a GA4 property.
- Run Report
- Read up to 100 rows across a date range of up to 31 days, with up to two dimensions, three metrics and three filters.
- Run Realtime Report
- Read activity from the last 30 minutes, with up to two dimensions, two metrics and 100 rows.
- Run Pivot Report
- Read a report across up to 31 days with one or two pivots and up to 100 combined rows.
- Run Preset Report
- Read traffic by channel, top pages or key events by source for up to 31 days, with up to 25 rows.
- Get Report Metadata
- List the property’s available report dimensions and metrics, including custom fields.
- Check Report Compatibility
- Check which dimensions and metrics can be combined in a standard report.
Limits
Standard report data can take Google 24 to 48 hours to process. This connection reads Analytics data and does not create or change properties.
Google data use and removal
The business customer controls workflows using the connected account. Google data can become input to an action that uses AI, such as LLM call, Agent or Decision. OAIZ sends that input to the LLM provider or TypeSafe AI decision engine used for the action to produce the requested output. OAIZ does not use Google data to train, fine-tune or improve AI models. OAIZ does not sell Google data or share it for advertising.
OAIZ stores connection credentials while services are connected. Google data can also be stored in workflow events, execution history and files. Removing a service does not erase these retained records. The privacy policy and Data Processing Agreement explain storage, sharing, retention and deletion. Contact the business customer or support@oaiz.io to request deletion of retained data.
Removing one Google service stops its OAIZ actions and subscriptions. Other services on the same account keep the shared connection and accumulated Google permissions. Removing the final service deletes the stored credential and requests revocation at Google. The disconnect result reports whether Google confirmed revocation.
OAIZ’s use and transfer of Google API data follows Google’s Limited Use requirements. For Gmail, Google Calendar and Google Drive, OAIZ also follows the additional requirements of the Google Workspace API User Data and Developer Policy described in the privacy policy.