Skip to main content

Google Analytics

Access Google Analytics 4 properties, data streams, custom dimensions and metrics, audiences, and run custom reports via the Admin and Data APIs.

What you can ask​

  • Run a report on sessions and conversions by landing page for the last 28 days.
  • List all custom dimensions in the Production GA4 property and flag unused ones.
  • Compare weekly traffic from paid and organic channels and summarize the trend.

Set up​

Google Analytics needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.

  1. Go to Organization > Connectors and find Google Analytics. Click Enable, and choose which tools to allow.
  2. Create a Google Cloud project.
  3. Turn on the Google Analytics Data API.
  4. Configure the OAuth consent screen.
  5. Create credentials, choose OAuth client ID, and set the type to Web application.
  6. Add the exact Redirect URI shown in the connector settings.
  7. Copy the client ID and client secret into the connector, then save it.
  8. Each member connects their own account the first time they use it.

⚠️ Warning: Do not enter your Devs.ai or Google Analytics login email or password in the OAuth application fields.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

OAuth scopes used by these tools (2)

Grant the scopes for the tools you plan to allow.

  • https://www.googleapis.com/auth/analytics
  • https://www.googleapis.com/auth/analytics.readonly

Tools​

Google Analytics offers 32 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (20)​

View and search information without changing it.

ToolWhat it does
batch_run_reportsRun multiple reports in a single API call.
check_compatibilityValidate that dimensions and metrics are compatible for reporting.
get_accountGet details of a specific Google Analytics account by ID.
get_audienceGet details of a specific audience.
get_custom_dimensionGet details of a specific custom dimension.
get_custom_metricGet details of a specific custom metric.
get_data_streamGet details of a specific data stream.
get_key_eventGet details of a specific key event.
get_metadataGet all available dimensions and metrics for a property.
get_propertyGet details of a specific Google Analytics property.
list_accountsList all Google Analytics accounts you have access to.
list_audiencesList audiences for a property.
list_custom_dimensionsList custom dimensions for a property.
list_custom_metricsList custom metrics for a property.
list_data_streamsList data streams (websites or mobile apps) for a property.
list_key_eventsList key events (conversions) for a property.
list_propertiesList Google Analytics properties under an account.
run_realtime_reportGet real-time event data (30-60 minute window) for a property.
run_reportGenerate a custom Google Analytics report with dimensions, metrics, and filters.
validate_credentialValidate Google Analytics OAuth2 credentials by listing accounts.

Write (6)​

Create or send data.

ToolWhat it does
create_audienceCreate a new audience for a property.
create_custom_dimensionCreate a new custom dimension for a property.
create_custom_metricCreate a new custom metric for a property.
create_data_streamCreate a new data stream (website or mobile app) for a property.
create_key_eventCreate a new key event (conversion) for a property.
create_propertyCreate a new Google Analytics property in an account.

Delete or overwrite (6)​

Remove or replace existing data.

ToolWhat it does
delete_key_eventDelete a key event (conversion) from a property.
update_accountUpdate a Google Analytics account's display name.
update_audienceUpdate an audience's display name or description.
update_custom_dimensionUpdate a custom dimension's display name or description.
update_custom_metricUpdate a custom metric's display name or description.
update_propertyUpdate a Google Analytics property's settings (display name, timezone, currency code).
⌘J