Google Analytics Admin API Client Library

Common errors

Warnings

Install compatibility verified last tested: 2026-05-12

Imports

• AnalyticsAdminServiceClient
  wrong

  from google.analytics.admin import AnalyticsAdminServiceClient

  correct

  from google.analytics.admin_v1beta import AnalyticsAdminServiceClient

  Always specify the API version (e.g., `_v1beta` or `_v1alpha`) in the import path. The higher-level `google.analytics.admin` module typically exists but might not contain the concrete client or expose the correct version by default. `v1beta` is generally recommended for stable features.

• AnalyticsAdminServiceAsyncClient

  from google.analytics.admin_v1beta import AnalyticsAdminServiceAsyncClient

  For asynchronous operations, import the `AsyncClient`.

Quickstart verified last tested: 2026-04-24

This quickstart demonstrates how to instantiate the `AnalyticsAdminServiceClient` and list all accessible Google Analytics account summaries. Authentication is typically handled automatically if the `GOOGLE_APPLICATION_CREDENTIALS` environment variable is set to the path of a service account key file. Ensure the service account has appropriate permissions (e.g., 'Google Analytics Administrator').

import os
from google.analytics.admin_v1beta import AnalyticsAdminServiceClient

# Ensure GOOGLE_APPLICATION_CREDENTIALS environment variable is set
# or pass credentials explicitly.
# Example: os.environ['GOOGLE_APPLICATION_CREDENTIALS'] = '/path/to/your/key.json'

def list_account_summaries():
    """Lists all accessible account summaries for the authenticated user."""
    try:
        client = AnalyticsAdminServiceClient()
        print("Listing account summaries:")
        for account_summary in client.list_account_summaries():
            print(f"  Account: {account_summary.display_name} ({account_summary.account})")
            for property_summary in account_summary.property_summaries:
                print(f"    Property: {property_summary.display_name} ({property_summary.property}) - Type: {property_summary.property_type}")
    except Exception as e:
        print(f"An error occurred: {e}")
        print("Please ensure you have set up authentication (e.g., GOOGLE_APPLICATION_CREDENTIALS) and enabled the Analytics Admin API.")

if __name__ == '__main__':
    list_account_summaries()