Google Analytics - UA Component
Manage Google Analytics
Component key: google-analytics · · Changelog ↓Description
Google Analytics is Google's platform of analytics tooling. This component provides actions related to the Universal Analytics (UA) API.
On July 1st 2023, UA will stop processing analytics data in favor of Google Analytics 4. If you are building a new integration, please see the Google Analytics - GA4 component.
Connections
Google Analytics OAuth 2.0
key: oauth2The Google Analytics component authenticates requests through Google's OAuth 2.0 service.
To create a Google Analytics developer account and authenticate, follow their Configure OAuth Consent guide
Now, you will have to configure OAuth 2.0 settings. Create a new Google Analytics connection of type OAuth 2.0.
- For Client ID and Client Secret enter the values that you got from the Google Cloud Platform auth settings.
- For Scopes choose from the list found on Google's service scopes documentation
App Verification
Google requires OAuth apps that request access to user data to pass a verification review before being deployed at scale. This process ensures the app complies with Google's API Services User Data Policy, accurately represents its functionality, and handles user data responsibly.
Google OAuth apps pass through three stages before they are ready for production use.
Testing (unpublished): The app is only accessible to users manually added as test users in the OAuth consent screen. Up to 100 test users are allowed — all other users receive an error. This is the expected state during initial development.
Published, unverified: After publishing the app, all Google users can authenticate. However, for sensitive scopes, users see a "This app isn't verified" warning. Users can proceed by clicking Advanced → Go to [app name] (unsafe), but this warning reduces trust and may be blocked by organizations with strict Google Workspace policies.
Verified: Google has reviewed and approved the app. No warning is shown. Verification is required before deploying to production users.
Publishing the App
Publishing is required before any users outside the test list can authenticate:
- In the Google Cloud Console, navigate to APIs & Services → OAuth consent screen
- Click PUBLISH APP and confirm
Requesting Verification
The scopes used by this component are classified as sensitive by Google. Submitting for verification removes the "This app isn't verified" warning:
- On the OAuth consent screen, click Prepare for verification
- Provide a privacy policy URL, authorized domain, and app logo
- Submit for review — Google typically responds within several weeks
Refer to Google's OAuth consent screen documentation for the full verification requirements.
| Input | Notes | Example |
|---|---|---|
| Authorize URL | The OAuth 2.0 Authorization URL for Google Calendar | https://accounts.google.com/o/oauth2/v2/auth?access_type=offline&prompt=consent |
| Client ID | Provide a string value for the client Id of your OAuth 2.0 application. | |
| Client Secret | Provide a string value for the client secret of your OAuth 2.0 application. | |
| Scopes | A space-delimited set of one or more scopes to get the user's permission to access. | https://www.googleapis.com/auth/analytics https://www.googleapis.com/auth/analytics.manage.users https://www.googleapis.com/auth/analytics.edit https://www.googleapis.com/auth/analytics.readonly |
| Token URL | The OAuth 2.0 Token URL for Google Analytics | https://oauth2.googleapis.com/token |
Data Sources
Account Names
A picklist of account names | key: accountNames | type: picklist
| Input | Notes | Example |
|---|---|---|
| Connection |
Custom Metrics
A picklist of Custom Metrics | key: getCustomMetric | type: picklist
| Input | Notes | Example |
|---|---|---|
| Account ID | 37746615 | |
| Connection | ||
| Web Property ID | UA-12345678-1 |
Select Custom Dimension
A picklist of custom dimensions for the specified web property. | key: selectCustomDimension | type: picklist
| Input | Notes | Example |
|---|---|---|
| Account ID | 37746615 | |
| Connection | ||
| Web Property ID | UA-12345678-1 |
Example Payload for Select Custom Dimension⤓
Views (Profiles)
A picklist of views (profiles) | key: profiles | type: picklist
| Input | Notes | Example |
|---|---|---|
| Account ID | 37746615 | |
| Connection | ||
| Web Property ID | ~all |
Web Property
A picklist of Web Properties | key: getWebProperty | type: picklist
| Input | Notes | Example |
|---|---|---|
| Account ID | 37746615 | |
| Connection |
Actions
Get Custom Dimension
Get a Custom Dimensions | key: getCustomDimension
| Input | Notes | Example |
|---|---|---|
| Account ID | 37746615 | |
| Connection | ||
| Custom Dimension ID | ||
| Web Property ID | UA-12345678-1 |
Get Custom Metric
Get a Custom Metric | key: getCustomMetric
| Input | Notes | Example |
|---|---|---|
| Account ID | 37746615 | |
| Connection | ||
| Custom Metric ID | ||
| Web Property ID | UA-12345678-1 |
Get Profile
Get a Google Analytics Profile | key: getProfile
| Input | Notes | Example |
|---|---|---|
| Account ID | 37746615 | |
| Connection | ||
| Profile ID | ||
| Web Property ID |
Get View Data
Get Analytics data for a View (profile) | key: getData
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| Additional Dimensions | Must be a comma seperated list of dimensions i.e. 'ga:browser,ga:city' | |
| Additional Metrics | Must be a comma seperated list of metrics i.e. 'ga:sesions,ga:pageviews' | |
| Standard Dimensions | ga:browser | |
| End Date | 2022-02-02 | |
| Filters | ||
| Profile ID | 840123345 | |
| Include Empty Rows | false | |
| Items Per Page | 1000 | |
| Standard Metrics | ga:pageviews | |
| Analytics Segment | ||
| Start Date | 2022-02-01 | |
| Start Index | 1 |
Get Web Property
Get Web Property | key: getWebProperty
| Input | Notes | Example |
|---|---|---|
| Account ID | 37746615 | |
| Connection | ||
| Web Property ID | UA-12345678-1 |
Link User to Account
Link a User by email to specified Account | key: addUser
| Input | Notes | Example |
|---|---|---|
| Account ID | ||
| Connection | ||
List Accounts
Paginated listing of Accounts | key: listAccounts
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| Items Per Page | 1000 | |
| Start Index | 1 |
List Custom Dimensions
List Custom Dimensions for the given Web Property | key: listCustomDimensions
| Input | Notes | Example |
|---|---|---|
| Account ID | 37746615 | |
| Connection | ||
| Items Per Page | 1000 | |
| Start Index | 1 | |
| Web Property ID | UA-12345678-1 |
List Custom Metrics
List Custom Metrics for the given Web Property | key: listCustomMetrics
| Input | Notes | Example |
|---|---|---|
| Account ID | 37746615 | |
| Connection | ||
| Items Per Page | 1000 | |
| Start Index | 1 | |
| Web Property ID | UA-12345678-1 |
List Profiles
List Profiles associated with the specified Account ID | key: listProfiles
| Input | Notes | Example |
|---|---|---|
| Account ID | 37746615 | |
| Connection | ||
| Items Per Page | 1000 | |
| Start Index | 1 | |
| Web Property ID | ~all |
List Web Properties
List Web Properties associated with the specified Account ID | key: listWebProperties
| Input | Notes | Example |
|---|---|---|
| Account ID | 37746615 | |
| Connection | ||
| Items Per Page | 1000 | |
| Start Index | 1 |
Raw Request
Send raw HTTP request to Google Analytics | key: rawRequest
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| Data | The HTTP body payload to send to the URL. | {"exampleKey": "Example Data"} |
| File Data | File Data to be sent as a multipart form upload. | [{key: "example.txt", value: "My File Contents"}] |
| File Data File Names | File names to apply to the file data inputs. Keys must match the file data keys above. | |
| Form Data | The Form Data to be sent as a multipart form upload. | [{"key": "Example Key", "value": new Buffer("Hello World")}] |
| Header | A list of headers to send with the request. | User-Agent: curl/7.64.1 |
| Max Retry Count | The maximum number of retries to attempt. Specify 0 for no retries. | 0 |
| Method | The HTTP method to use. | |
| Query Parameter | A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2. | |
| Response Type | The type of data you expect in the response. You can request json, text, or binary data. | json |
| Retry On All Errors | If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors. | false |
| Retry Delay (ms) | The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled. | 0 |
| Timeout | The maximum time that a client will await a response to its request | 2000 |
| URL | Input the path only (/management/accounts), The base URL is already included (https://www.googleapis.com/analytics/v3). For example, to connect to https://www.googleapis.com/analytics/v3/management/accounts, only /management/accounts is entered in this field. | /management/accounts |
| Use Exponential Backoff | Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored. | false |
Changelog
2026-04-30
Updated spectral version
2026-04-07
Added global debug support across all actions for improved troubleshooting
2026-03-05
Added inline data sources for accounts, web properties, profiles, custom metrics, and custom dimensions to enhance data selection capabilities