As of January 1, 2020 this library no longer supports Python 2 on the latest released version. Library versions released prior to that date will continue to be available. For more information please visit Python 2 support on Google Cloud.

Types for Google Analytics Admin v1alpha API

class google.analytics.admin_v1alpha.types.Account(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A resource message representing a Google Analytics account. .. attribute:: name

Output only. Resource name of this account. Format: accounts/{account} Example: “accounts/100”.

type

str

create_time

Output only. Time when this account was originally created.

Type

google.protobuf.timestamp_pb2.Timestamp

update_time

Output only. Time when account payload fields were last updated.

Type

google.protobuf.timestamp_pb2.Timestamp

display_name

Required. Human-readable display name for this account.

Type

str

region_code

Country of business. Must be a Unicode CLDR region code.

Type

str

deleted

Output only. Indicates whether this Account is soft-deleted or not. Deleted accounts are excluded from List results unless specifically requested.

Type

bool

class google.analytics.admin_v1alpha.types.AccountSummary(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A virtual resource representing an overview of an account and all its child GA4 properties.

name

Resource name for this account summary. Format: accountSummaries/{account_id} Example: “accountSummaries/1000”.

Type

str

account

Resource name of account referred to by this account summary Format: accounts/{account_id} Example: “accounts/1000”.

Type

str

display_name

Display name for the account referred to in this account summary.

Type

str

property_summaries

List of summaries for child accounts of this account.

Type

Sequence[google.analytics.admin_v1alpha.types.PropertySummary]

class google.analytics.admin_v1alpha.types.ActionType(value)

Bases: proto.enums.Enum

Types of actions that may change a resource.

ACTION_TYPE_UNSPECIFIED = 0

CREATED = 1

DELETED = 3

UPDATED = 2

class google.analytics.admin_v1alpha.types.ActorType(value)

Bases: proto.enums.Enum

Different kinds of actors that can make changes to Google Analytics resources.

ACTOR_TYPE_UNSPECIFIED = 0

SUPPORT = 3

SYSTEM = 2

USER = 1

class google.analytics.admin_v1alpha.types.AndroidAppDataStream(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A resource message representing a Google Analytics Android app stream.

name

Output only. Resource name of this Data Stream. Format: properties/{property_id}/androidAppDataStreams/{stream_id} Example: “properties/1000/androidAppDataStreams/2000”.

Type

str

firebase_app_id

Output only. ID of the corresponding Android app in Firebase, if any. This ID can change if the Android app is deleted and recreated.

Type

str

create_time

Output only. Time when this stream was originally created.

Type

google.protobuf.timestamp_pb2.Timestamp

update_time

Output only. Time when stream payload fields were last updated.

Type

google.protobuf.timestamp_pb2.Timestamp

package_name

Immutable. The package name for the app being measured. Example: “com.example.myandroidapp”.

Type

str

display_name

Human-readable display name for the Data Stream. The max allowed display name length is 255 UTF-16 code units.

Type

str

class google.analytics.admin_v1alpha.types.ArchiveCustomDimensionRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for ArchiveCustomDimension RPC. .. attribute:: name

Required. The name of the CustomDimension to archive. Example format: properties/1234/customDimensions/5678

type

str

class google.analytics.admin_v1alpha.types.ArchiveCustomMetricRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for ArchiveCustomMetric RPC. .. attribute:: name

Required. The name of the CustomMetric to archive. Example format: properties/1234/customMetrics/5678

type

str

class google.analytics.admin_v1alpha.types.AuditUserLink(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Read-only resource used to summarize a principal’s effective roles.

name

Example format: properties/1234/userLinks/5678

Type

str

email_address

Email address of the linked user

Type

str

direct_roles

Roles directly assigned to this user for this entity. Format: predefinedRoles/read

Excludes roles that are inherited from an account (if this is for a property), group, or organization admin role.

Type

Sequence[str]

effective_roles

Union of all permissions a user has at this account or property (includes direct permissions, group-inherited permissions, etc.). Format: predefinedRoles/read

Type

Sequence[str]

class google.analytics.admin_v1alpha.types.AuditUserLinksRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for AuditUserLinks RPC. .. attribute:: parent

Required. Example format: accounts/1234

type

str

page_size

The maximum number of user links to return. The service may return fewer than this value. If unspecified, at most 1000 user links will be returned. The maximum value is 5000; values above 5000 will be coerced to 5000.

Type

int

page_token

A page token, received from a previous AuditUserLinks call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to AuditUserLinks must match the call that provided the page token.

Type

str

class google.analytics.admin_v1alpha.types.AuditUserLinksResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Response message for AuditUserLinks RPC. .. attribute:: user_links

List of AuditUserLinks. These will be ordered stably, but in an arbitrary order.

type

Sequence[google.analytics.admin_v1alpha.types.AuditUserLink]

next_page_token

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

Type

str

property raw_page

class google.analytics.admin_v1alpha.types.BatchCreateUserLinksRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for BatchCreateUserLinks RPC. .. attribute:: parent

Required. The account or property that all user links in the request are for. This field is required. The parent field in the CreateUserLinkRequest messages must either be empty or match this field. Example format: accounts/1234

type

str

notify_new_users

Optional. If set, then email the new users notifying them that they’ve been granted permissions to the resource. Regardless of whether this is set or not, notify_new_user field inside each individual request is ignored.

Type

bool

requests

Required. The requests specifying the user links to create. A maximum of 1000 user links can be created in a batch.

Type

Sequence[google.analytics.admin_v1alpha.types.CreateUserLinkRequest]

class google.analytics.admin_v1alpha.types.BatchCreateUserLinksResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Response message for BatchCreateUserLinks RPC. .. attribute:: user_links

The user links created.

type

Sequence[google.analytics.admin_v1alpha.types.UserLink]

class google.analytics.admin_v1alpha.types.BatchDeleteUserLinksRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for BatchDeleteUserLinks RPC. .. attribute:: parent

Required. The account or property that all user links in the request are for. The parent of all values for user link names to delete must match this field. Example format: accounts/1234

type

str

requests

Required. The requests specifying the user links to update. A maximum of 1000 user links can be updated in a batch.

Type

Sequence[google.analytics.admin_v1alpha.types.DeleteUserLinkRequest]

class google.analytics.admin_v1alpha.types.BatchGetUserLinksRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for BatchGetUserLinks RPC. .. attribute:: parent

Required. The account or property that all user links in the request are for. The parent of all provided values for the ‘names’ field must match this field. Example format: accounts/1234

type

str

names

Required. The names of the user links to retrieve. A maximum of 1000 user links can be retrieved in a batch. Format: accounts/{accountId}/userLinks/{userLinkId}

Type

Sequence[str]

class google.analytics.admin_v1alpha.types.BatchGetUserLinksResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Response message for BatchGetUserLinks RPC. .. attribute:: user_links

The requested user links.

type

Sequence[google.analytics.admin_v1alpha.types.UserLink]

class google.analytics.admin_v1alpha.types.BatchUpdateUserLinksRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for BatchUpdateUserLinks RPC. .. attribute:: parent

Required. The account or property that all user links in the request are for. The parent field in the UpdateUserLinkRequest messages must either be empty or match this field. Example format: accounts/1234

type

str

requests

Required. The requests specifying the user links to update. A maximum of 1000 user links can be updated in a batch.

Type

Sequence[google.analytics.admin_v1alpha.types.UpdateUserLinkRequest]

class google.analytics.admin_v1alpha.types.BatchUpdateUserLinksResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Response message for BatchUpdateUserLinks RPC. .. attribute:: user_links

The user links updated.

type

Sequence[google.analytics.admin_v1alpha.types.UserLink]

class google.analytics.admin_v1alpha.types.ChangeHistoryChange(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A description of a change to a single Google Analytics resource.

resource

Resource name of the resource whose changes are described by this entry.

Type

str

action

The type of action that changed this resource.

Type

google.analytics.admin_v1alpha.types.ActionType

resource_before_change

Resource contents from before the change was made. If this resource was created in this change, this field will be missing.

Type

google.analytics.admin_v1alpha.types.ChangeHistoryChange.ChangeHistoryResource

resource_after_change

Resource contents from after the change was made. If this resource was deleted in this change, this field will be missing.

Type

google.analytics.admin_v1alpha.types.ChangeHistoryChange.ChangeHistoryResource

class ChangeHistoryResource(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A snapshot of a resource as before or after the result of a change in change history.

account

A snapshot of an Account resource in change history.

Type

google.analytics.admin_v1alpha.types.Account

property

A snapshot of a Property resource in change history.

Type

google.analytics.admin_v1alpha.types.Property

web_data_stream

A snapshot of a WebDataStream resource in change history.

Type

google.analytics.admin_v1alpha.types.WebDataStream

android_app_data_stream

A snapshot of an AndroidAppDataStream resource in change history.

Type

google.analytics.admin_v1alpha.types.AndroidAppDataStream

ios_app_data_stream

A snapshot of an IosAppDataStream resource in change history.

Type

google.analytics.admin_v1alpha.types.IosAppDataStream

firebase_link

A snapshot of a FirebaseLink resource in change history.

Type

google.analytics.admin_v1alpha.types.FirebaseLink

google_ads_link

A snapshot of a GoogleAdsLink resource in change history.

Type

google.analytics.admin_v1alpha.types.GoogleAdsLink

google_signals_settings

A snapshot of a GoogleSignalsSettings resource in change history.

Type

google.analytics.admin_v1alpha.types.GoogleSignalsSettings

conversion_event

A snapshot of a ConversionEvent resource in change history.

Type

google.analytics.admin_v1alpha.types.ConversionEvent

measurement_protocol_secret

A snapshot of a MeasurementProtocolSecret resource in change history.

Type

google.analytics.admin_v1alpha.types.MeasurementProtocolSecret

custom_dimension

A snapshot of a CustomDimension resource in change history.

Type

google.analytics.admin_v1alpha.types.CustomDimension

custom_metric

A snapshot of a CustomMetric resource in change history.

Type

google.analytics.admin_v1alpha.types.CustomMetric

class google.analytics.admin_v1alpha.types.ChangeHistoryEvent(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A set of changes within a Google Analytics account or its child properties that resulted from the same cause. Common causes would be updates made in the Google Analytics UI, changes from customer support, or automatic Google Analytics system changes.

id

ID of this change history event. This ID is unique across Google Analytics.

Type

str

change_time

Time when change was made.

Type

google.protobuf.timestamp_pb2.Timestamp

actor_type

The type of actor that made this change.

Type

google.analytics.admin_v1alpha.types.ActorType

user_actor_email

Email address of the Google account that made the change. This will be a valid email address if the actor field is set to USER, and empty otherwise. Google accounts that have been deleted will cause an error.

Type

str

changes_filtered

If true, then the list of changes returned was filtered, and does not represent all changes that occurred in this event.

Type

bool

changes

A list of changes made in this change history event that fit the filters specified in SearchChangeHistoryEventsRequest.

Type

Sequence[google.analytics.admin_v1alpha.types.ChangeHistoryChange]

class google.analytics.admin_v1alpha.types.ChangeHistoryResourceType(value)

Bases: proto.enums.Enum

Types of resources whose changes may be returned from change history.

ACCOUNT = 1

ANDROID_APP_DATA_STREAM = 4

CHANGE_HISTORY_RESOURCE_TYPE_UNSPECIFIED = 0

CONVERSION_EVENT = 9

CUSTOM_DIMENSION = 11

CUSTOM_METRIC = 12

FIREBASE_LINK = 6

GOOGLE_ADS_LINK = 7

GOOGLE_SIGNALS_SETTINGS = 8

IOS_APP_DATA_STREAM = 5

MEASUREMENT_PROTOCOL_SECRET = 10

PROPERTY = 2

WEB_DATA_STREAM = 3

class google.analytics.admin_v1alpha.types.ConversionEvent(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A conversion event in a Google Analytics property. .. attribute:: name

Output only. Resource name of this conversion event. Format: properties/{property}/conversionEvents/{conversion_event}

type

str

event_name

Immutable. The event name for this conversion event. Examples: ‘click’, ‘purchase’

Type

str

create_time

Output only. Time when this conversion event was created in the property.

Type

google.protobuf.timestamp_pb2.Timestamp

is_deletable

Output only. If set, this event can currently be deleted via DeleteConversionEvent.

Type

bool

class google.analytics.admin_v1alpha.types.CreateConversionEventRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for CreateConversionEvent RPC .. attribute:: conversion_event

Required. The conversion event to create.

type

google.analytics.admin_v1alpha.types.ConversionEvent

parent

Required. The resource name of the parent property where this conversion event will be created. Format: properties/123

Type

str

class google.analytics.admin_v1alpha.types.CreateCustomDimensionRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for CreateCustomDimension RPC. .. attribute:: parent

Required. Example format: properties/1234

type

str

custom_dimension

Required. The CustomDimension to create.

Type

google.analytics.admin_v1alpha.types.CustomDimension

class google.analytics.admin_v1alpha.types.CreateCustomMetricRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for CreateCustomMetric RPC. .. attribute:: parent

Required. Example format: properties/1234

type

str

custom_metric

Required. The CustomMetric to create.

Type

google.analytics.admin_v1alpha.types.CustomMetric

class google.analytics.admin_v1alpha.types.CreateFirebaseLinkRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for CreateFirebaseLink RPC .. attribute:: parent

Required. Format: properties/{property_id} Example: properties/1234

type

str

firebase_link

Required. The Firebase link to create.

Type

google.analytics.admin_v1alpha.types.FirebaseLink

class google.analytics.admin_v1alpha.types.CreateGoogleAdsLinkRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for CreateGoogleAdsLink RPC .. attribute:: parent

Required. Example format: properties/1234

type

str

google_ads_link

Required. The GoogleAdsLink to create.

Type

google.analytics.admin_v1alpha.types.GoogleAdsLink

class google.analytics.admin_v1alpha.types.CreateMeasurementProtocolSecretRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for CreateMeasurementProtocolSecret RPC .. attribute:: parent

Required. The parent resource where this secret will be created. Any type of stream (WebDataStream, IosAppDataStream, AndroidAppDataStream) may be a parent. Format: properties/{property}/webDataStreams/{webDataStream}

type

str

measurement_protocol_secret

Required. The measurement protocol secret to create.

Type

google.analytics.admin_v1alpha.types.MeasurementProtocolSecret

class google.analytics.admin_v1alpha.types.CreatePropertyRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for CreateProperty RPC. .. attribute:: property

Required. The property to create. Note: the supplied property must specify its parent.

type

google.analytics.admin_v1alpha.types.Property

class google.analytics.admin_v1alpha.types.CreateUserLinkRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for CreateUserLink RPC. Users can have multiple email addresses associated with their Google account, and one of these email addresses is the “primary” email address. Any of the email addresses associated with a Google account may be used for a new UserLink, but the returned UserLink will always contain the “primary” email address. As a result, the input and output email address for this request may differ.

parent

Required. Example format: accounts/1234

Type

str

notify_new_user

Optional. If set, then email the new user notifying them that they’ve been granted permissions to the resource.

Type

bool

user_link

Required. The user link to create.

Type

google.analytics.admin_v1alpha.types.UserLink

class google.analytics.admin_v1alpha.types.CreateWebDataStreamRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for CreateWebDataStream RPC. .. attribute:: web_data_stream

Required. The web stream to create.

type

google.analytics.admin_v1alpha.types.WebDataStream

parent

Required. The parent resource where this web data stream will be created. Format: properties/123

Type

str

class google.analytics.admin_v1alpha.types.CustomDimension(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A definition for a CustomDimension. .. attribute:: name

Output only. Resource name for this CustomDimension resource. Format: properties/{property}/customDimensions/{customDimension}

type

str

parameter_name

Required. Immutable. Tagging parameter name for this custom dimension. If this is a user-scoped dimension, then this is the user property name. If this is an event- scoped dimension, then this is the event parameter name.

May only contain alphanumeric and underscore characters, starting with a letter. Max length of 24 characters for user-scoped dimensions, 40 characters for event-scoped dimensions.

Type

str

display_name

Required. Display name for this custom dimension as shown in the Analytics UI. Max length of 82 characters, alphanumeric plus space and underscore starting with a letter. Legacy system-generated display names may contain square brackets, but updates to this field will never permit square brackets.

Type

str

description

Optional. Description for this custom dimension. Max length of 150 characters.

Type

str

scope

Required. Immutable. The scope of this dimension.

Type

google.analytics.admin_v1alpha.types.CustomDimension.DimensionScope

disallow_ads_personalization

Optional. If set to true, sets this dimension as NPA and excludes it from ads personalization. This is currently only supported by user-scoped custom dimensions.

Type

bool

class DimensionScope(value)

Bases: proto.enums.Enum

Valid values for the scope of this dimension.

DIMENSION_SCOPE_UNSPECIFIED = 0

EVENT = 1

USER = 2

class google.analytics.admin_v1alpha.types.CustomMetric(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A definition for a custom metric. .. attribute:: name

Output only. Resource name for this CustomMetric resource. Format: properties/{property}/customMetrics/{customMetric}

type

str

parameter_name

Required. Immutable. Tagging name for this custom metric. If this is an event-scoped metric, then this is the event parameter name.

May only contain alphanumeric and underscore charactes, starting with a letter. Max length of 40 characters for event-scoped metrics.

Type

str

display_name

Required. Display name for this custom metric as shown in the Analytics UI. Max length of 82 characters, alphanumeric plus space and underscore starting with a letter. Legacy system-generated display names may contain square brackets, but updates to this field will never permit square brackets.

Type

str

description

Optional. Description for this custom dimension. Max length of 150 characters.

Type

str

measurement_unit

Required. Immutable. The type for the custom metric’s value.

Type

google.analytics.admin_v1alpha.types.CustomMetric.MeasurementUnit

scope

Required. Immutable. The scope of this custom metric.

Type

google.analytics.admin_v1alpha.types.CustomMetric.MetricScope

class MeasurementUnit(value)

Bases: proto.enums.Enum

Possible types of representing the custom metric’s value. Currency representation may change in the future, requiring a breaking API change.

CURRENCY = 2

FEET = 3

HOURS = 10

KILOMETERS = 5

MEASUREMENT_UNIT_UNSPECIFIED = 0

METERS = 4

MILES = 6

MILLISECONDS = 7

MINUTES = 9

SECONDS = 8

STANDARD = 1

class MetricScope(value)

Bases: proto.enums.Enum

The scope of this metric.

EVENT = 1

METRIC_SCOPE_UNSPECIFIED = 0

class google.analytics.admin_v1alpha.types.DataSharingSettings(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A resource message representing data sharing settings of a Google Analytics account.

name

Output only. Resource name. Format: accounts/{account}/dataSharingSettings Example: “accounts/1000/dataSharingSettings”.

Type

str

sharing_with_google_support_enabled

Allows Google support to access the data in order to help troubleshoot issues.

Type

bool

sharing_with_google_assigned_sales_enabled

Allows Google sales teams that are assigned to the customer to access the data in order to suggest configuration changes to improve results. Sales team restrictions still apply when enabled.

Type

bool

sharing_with_google_any_sales_enabled

Allows any of Google sales to access the data in order to suggest configuration changes to improve results.

Type

bool

sharing_with_google_products_enabled

Allows Google to use the data to improve other Google products or services.

Type

bool

sharing_with_others_enabled

Allows Google to share the data anonymously in aggregate form with others.

Type

bool

class google.analytics.admin_v1alpha.types.DeleteAccountRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for DeleteAccount RPC. .. attribute:: name

Required. The name of the Account to soft- elete. Format: accounts/{account} Example: “accounts/100”.

type

str

class google.analytics.admin_v1alpha.types.DeleteAndroidAppDataStreamRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for DeleteAndroidAppDataStream RPC. .. attribute:: name

Required. The name of the android app data stream to delete. Format: properties/{property_id}/androidAppDataStreams/{stream_id} Example: “properties/123/androidAppDataStreams/456”.

type

str

class google.analytics.admin_v1alpha.types.DeleteConversionEventRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for DeleteConversionEvent RPC .. attribute:: name

Required. The resource name of the conversion event to delete. Format: properties/{property}/conversionEvents/{conversion_event} Example: “properties/123/conversionEvents/456”.

type

str

class google.analytics.admin_v1alpha.types.DeleteFirebaseLinkRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for DeleteFirebaseLink RPC .. attribute:: name

Required. Format: properties/{property_id}/firebaseLinks/{firebase_link_id} Example: properties/1234/firebaseLinks/5678

type

str

class google.analytics.admin_v1alpha.types.DeleteGoogleAdsLinkRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for DeleteGoogleAdsLink RPC. .. attribute:: name

Required. Example format: properties/1234/googleAdsLinks/5678

type

str

class google.analytics.admin_v1alpha.types.DeleteIosAppDataStreamRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for DeleteIosAppDataStream RPC. .. attribute:: name

Required. The name of the iOS app data stream to delete. Format: properties/{property_id}/iosAppDataStreams/{stream_id} Example: “properties/123/iosAppDataStreams/456”.

type

str

class google.analytics.admin_v1alpha.types.DeleteMeasurementProtocolSecretRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for DeleteMeasurementProtocolSecret RPC .. attribute:: name

Required. The name of the MeasurementProtocolSecret to delete. Format: properties/{property}/webDataStreams/{webDataStream}/measurementProtocolSecrets/{measurementProtocolSecret} Note: Any type of stream (WebDataStream, IosAppDataStream, AndroidAppDataStream) may be a parent.

type

str

class google.analytics.admin_v1alpha.types.DeletePropertyRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for DeleteProperty RPC. .. attribute:: name

Required. The name of the Property to soft-delete. Format: properties/{property_id} Example: “properties/1000”.

type

str

class google.analytics.admin_v1alpha.types.DeleteUserLinkRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for DeleteUserLink RPC. .. attribute:: name

Required. Example format: accounts/1234/userLinks/5678

type

str

class google.analytics.admin_v1alpha.types.DeleteWebDataStreamRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for DeleteWebDataStream RPC. .. attribute:: name

Required. The name of the web data stream to delete. Format: properties/{property_id}/webDataStreams/{stream_id} Example: “properties/123/webDataStreams/456”.

type

str

class google.analytics.admin_v1alpha.types.EnhancedMeasurementSettings(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Singleton resource under a WebDataStream, configuring measurement of additional site interactions and content.

name

Output only. Resource name of this Data Stream. Format: properties/{property_id}/webDataStreams/{stream_id}/enhancedMeasurementSettings Example: “properties/1000/webDataStreams/2000/enhancedMeasurementSettings”.

Type

str

stream_enabled

Indicates whether Enhanced Measurement Settings will be used to automatically measure interactions and content on this web stream. Changing this value does not affect the settings themselves, but determines whether they are respected.

Type

bool

page_views_enabled

Output only. If enabled, capture a page view event each time a page loads or the website changes the browser history state.

Type

bool

scrolls_enabled

If enabled, capture scroll events each time a visitor gets to the bottom of a page.

Type

bool

outbound_clicks_enabled

If enabled, capture an outbound click event each time a visitor clicks a link that leads them away from your domain.

Type

bool

site_search_enabled

If enabled, capture a view search results event each time a visitor performs a search on your site (based on a query parameter).

Type

bool

video_engagement_enabled

If enabled, capture video play, progress, and complete events as visitors view embedded videos on your site.

Type

bool

file_downloads_enabled

If enabled, capture a file download event each time a link is clicked with a common document, compressed file, application, video, or audio extension.

Type

bool

page_loads_enabled

Output only. If enabled, capture a page view event each time a page loads.

Type

bool

page_changes_enabled

If enabled, capture a page view event each time the website changes the browser history state.

Type

bool

search_query_parameter

Required. URL query parameters to interpret as site search parameters. Max length is 1024 characters. Must not be empty.

Type

str

uri_query_parameter

Additional URL query parameters. Max length is 1024 characters.

Type

str

class google.analytics.admin_v1alpha.types.FirebaseLink(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A link between an GA4 property and a Firebase project. .. attribute:: name

Output only. Example format: properties/1234/firebaseLinks/5678

type

str

project

Immutable. Firebase project resource name. When creating a FirebaseLink, you may provide this resource name using either a project number or project ID. Once this resource has been created, returned FirebaseLinks will always have a project_name that contains a project number.

Format: ‘projects/{project number}’ Example: ‘projects/1234’

Type

str

create_time

Output only. Time when this FirebaseLink was originally created.

Type

google.protobuf.timestamp_pb2.Timestamp

maximum_user_access

Maximum user access to the GA4 property allowed to admins of the linked Firebase project.

Type

google.analytics.admin_v1alpha.types.MaximumUserAccess

class google.analytics.admin_v1alpha.types.GetAccountRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for GetAccount RPC. .. attribute:: name

Required. The name of the account to lookup. Format: accounts/{account} Example: “accounts/100”.

type

str

class google.analytics.admin_v1alpha.types.GetAndroidAppDataStreamRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for GetAndroidAppDataStream RPC. .. attribute:: name

Required. The name of the android app data stream to lookup. Format: properties/{property_id}/androidAppDataStreams/{stream_id} Example: “properties/123/androidAppDataStreams/456”.

type

str

class google.analytics.admin_v1alpha.types.GetConversionEventRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for GetConversionEvent RPC .. attribute:: name

Required. The resource name of the conversion event to retrieve. Format: properties/{property}/conversionEvents/{conversion_event} Example: “properties/123/conversionEvents/456”.

type

str

class google.analytics.admin_v1alpha.types.GetCustomDimensionRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for GetCustomDimension RPC. .. attribute:: name

Required. The name of the CustomDimension to get. Example format: properties/1234/customDimensions/5678

type

str

class google.analytics.admin_v1alpha.types.GetCustomMetricRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for GetCustomMetric RPC. .. attribute:: name

Required. The name of the CustomMetric to get. Example format: properties/1234/customMetrics/5678

type

str

class google.analytics.admin_v1alpha.types.GetDataSharingSettingsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for GetDataSharingSettings RPC. .. attribute:: name

Required. The name of the settings to lookup. Format: accounts/{account}/dataSharingSettings Example: “accounts/1000/dataSharingSettings”.

type

str

class google.analytics.admin_v1alpha.types.GetEnhancedMeasurementSettingsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for GetEnhancedMeasurementSettings RPC. .. attribute:: name

Required. The name of the settings to lookup. Format: properties/{property_id}/webDataStreams/{stream_id}/enhancedMeasurementSettings Example: “properties/1000/webDataStreams/2000/enhancedMeasurementSettings”.

type

str

class google.analytics.admin_v1alpha.types.GetGlobalSiteTagRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for GetGlobalSiteTag RPC. .. attribute:: name

Required. The name of the site tag to lookup. Note that site tags are singletons and do not have unique IDs. Format: properties/{property_id}/webDataStreams/{stream_id}/globalSiteTag Example: “properties/123/webDataStreams/456/globalSiteTag”.

type

str

class google.analytics.admin_v1alpha.types.GetGoogleSignalsSettingsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for GetGoogleSignalsSettings RPC .. attribute:: name

Required. The name of the google signals settings to retrieve. Format: properties/{property}/googleSignalsSettings

type

str

class google.analytics.admin_v1alpha.types.GetIosAppDataStreamRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for GetIosAppDataStream RPC. .. attribute:: name

Required. The name of the iOS app data stream to lookup. Format: properties/{property_id}/iosAppDataStreams/{stream_id} Example: “properties/123/iosAppDataStreams/456”.

type

str

class google.analytics.admin_v1alpha.types.GetMeasurementProtocolSecretRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for GetMeasurementProtocolSecret RPC. .. attribute:: name

Required. The name of the measurement protocol secret to lookup. Format: properties/{property}/webDataStreams/{webDataStream}/measurementProtocolSecrets/{measurementProtocolSecret} Note: Any type of stream (WebDataStream, IosAppDataStream, AndroidAppDataStream) may be a parent.

type

str

class google.analytics.admin_v1alpha.types.GetPropertyRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for GetProperty RPC. .. attribute:: name

Required. The name of the property to lookup. Format: properties/{property_id} Example: “properties/1000”.

type

str

class google.analytics.admin_v1alpha.types.GetUserLinkRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for GetUserLink RPC. .. attribute:: name

Required. Example format: accounts/1234/userLinks/5678

type

str

class google.analytics.admin_v1alpha.types.GetWebDataStreamRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for GetWebDataStream RPC. .. attribute:: name

Required. The name of the web data stream to lookup. Format: properties/{property_id}/webDataStreams/{stream_id} Example: “properties/123/webDataStreams/456”.

type

str

class google.analytics.admin_v1alpha.types.GlobalSiteTag(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Read-only resource with the tag for sending data from a website to a WebDataStream.

name

Output only. Resource name for this GlobalSiteTag resource. Format: properties/{propertyId}/globalSiteTag

Type

str

snippet

Immutable. JavaScript code snippet to be pasted as the first item into the head tag of every webpage to measure.

Type

str

class google.analytics.admin_v1alpha.types.GoogleAdsLink(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A link between an GA4 property and a Google Ads account. .. attribute:: name

Output only. Format: properties/{propertyId}/googleAdsLinks/{googleAdsLinkId} Note: googleAdsLinkId is not the Google Ads customer ID.

type

str

customer_id

Immutable. Google Ads customer ID.

Type

str

can_manage_clients

Output only. If true, this link is for a Google Ads manager account.

Type

bool

ads_personalization_enabled

Enable personalized advertising features with this integration. Automatically publish my Google Analytics audience lists and Google Analytics remarketing events/parameters to the linked Google Ads account. If this field is not set on create/update, it will be defaulted to true.

Type

google.protobuf.wrappers_pb2.BoolValue

email_address

Output only. Email address of the user that created the link. An empty string will be returned if the email address can’t be retrieved.

Type

str

create_time

Output only. Time when this link was originally created.

Type

google.protobuf.timestamp_pb2.Timestamp

update_time

Output only. Time when this link was last updated.

Type

google.protobuf.timestamp_pb2.Timestamp

class google.analytics.admin_v1alpha.types.GoogleSignalsConsent(value)

Bases: proto.enums.Enum

Consent field of the Google Signals settings (i.e., whether the user has consented to the Google Signals terms of service.)

GOOGLE_SIGNALS_CONSENT_CONSENTED = 2

GOOGLE_SIGNALS_CONSENT_NOT_CONSENTED = 1

GOOGLE_SIGNALS_CONSENT_UNSPECIFIED = 0

class google.analytics.admin_v1alpha.types.GoogleSignalsSettings(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Settings values for Google Signals. This is a singleton resource.

name

Output only. Resource name of this setting. Format: properties/{property_id}/googleSignalsSettings Example: “properties/1000/googleSignalsSettings”.

Type

str

state

Status of this setting.

Type

google.analytics.admin_v1alpha.types.GoogleSignalsState

consent

Output only. Terms of Service acceptance.

Type

google.analytics.admin_v1alpha.types.GoogleSignalsConsent

class google.analytics.admin_v1alpha.types.GoogleSignalsState(value)

Bases: proto.enums.Enum

Status of the Google Signals settings (i.e., whether this feature has been enabled for the property).

GOOGLE_SIGNALS_DISABLED = 2

GOOGLE_SIGNALS_ENABLED = 1

GOOGLE_SIGNALS_STATE_UNSPECIFIED = 0

class google.analytics.admin_v1alpha.types.IndustryCategory(value)

Bases: proto.enums.Enum

The category selected for this property, used for industry benchmarking.

ARTS_AND_ENTERTAINMENT = 8

AUTOMOTIVE = 1

BEAUTY_AND_FITNESS = 9

BOOKS_AND_LITERATURE = 10

BUSINESS_AND_INDUSTRIAL_MARKETS = 2

FINANCE = 3

FOOD_AND_DRINK = 11

GAMES = 12

HEALTHCARE = 4

HOBBIES_AND_LEISURE = 13

HOME_AND_GARDEN = 14

INDUSTRY_CATEGORY_UNSPECIFIED = 0

INTERNET_AND_TELECOM = 15

JOBS_AND_EDUCATION = 25

LAW_AND_GOVERNMENT = 16

NEWS = 17

ONLINE_COMMUNITIES = 18

OTHER = 7

PEOPLE_AND_SOCIETY = 19

PETS_AND_ANIMALS = 20

REAL_ESTATE = 21

REFERENCE = 22

SCIENCE = 23

SHOPPING = 26

SPORTS = 24

TECHNOLOGY = 5

TRAVEL = 6

class google.analytics.admin_v1alpha.types.IosAppDataStream(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A resource message representing a Google Analytics IOS app stream.

name

Output only. Resource name of this Data Stream. Format: properties/{property_id}/iosAppDataStreams/{stream_id} Example: “properties/1000/iosAppDataStreams/2000”.

Type

str

firebase_app_id

Output only. ID of the corresponding iOS app in Firebase, if any. This ID can change if the iOS app is deleted and recreated.

Type

str

create_time

Output only. Time when this stream was originally created.

Type

google.protobuf.timestamp_pb2.Timestamp

update_time

Output only. Time when stream payload fields were last updated.

Type

google.protobuf.timestamp_pb2.Timestamp

bundle_id

Required. Immutable. The Apple App Store Bundle ID for the app Example: “com.example.myiosapp”.

Type

str

display_name

Human-readable display name for the Data Stream. The max allowed display name length is 255 UTF-16 code units.

Type

str

class google.analytics.admin_v1alpha.types.ListAccountSummariesRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for ListAccountSummaries RPC. .. attribute:: page_size

The maximum number of AccountSummary resources to return. The service may return fewer than this value, even if there are additional pages. If unspecified, at most 50 resources will be returned. The maximum value is 200; (higher values will be coerced to the maximum)

type

int

page_token

A page token, received from a previous ListAccountSummaries call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListAccountSummaries must match the call that provided the page token.

Type

str

class google.analytics.admin_v1alpha.types.ListAccountSummariesResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Response message for ListAccountSummaries RPC. .. attribute:: account_summaries

Account summaries of all accounts the caller has access to.

type

Sequence[google.analytics.admin_v1alpha.types.AccountSummary]

next_page_token

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

Type

str

property raw_page

class google.analytics.admin_v1alpha.types.ListAccountsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for ListAccounts RPC. .. attribute:: page_size

The maximum number of resources to return. The service may return fewer than this value, even if there are additional pages. If unspecified, at most 50 resources will be returned. The maximum value is 200; (higher values will be coerced to the maximum)

type

int

page_token

A page token, received from a previous ListAccounts call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListAccounts must match the call that provided the page token.

Type

str

show_deleted

Whether to include soft-deleted (ie: “trashed”) Accounts in the results. Accounts can be inspected to determine whether they are deleted or not.

Type

bool

class google.analytics.admin_v1alpha.types.ListAccountsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for ListAccounts RPC. .. attribute:: accounts

Results that were accessible to the caller.

type

Sequence[google.analytics.admin_v1alpha.types.Account]

next_page_token

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

Type

str

property raw_page

class google.analytics.admin_v1alpha.types.ListAndroidAppDataStreamsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for ListAndroidAppDataStreams RPC. .. attribute:: parent

Required. The name of the parent property. For example, to limit results to app streams under the property with Id 123: “properties/123”.

type

str

page_size

The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200; (higher values will be coerced to the maximum)

Type

int

page_token

A page token, received from a previous call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListAndroidAppDataStreams must match the call that provided the page token.

Type

str

class google.analytics.admin_v1alpha.types.ListAndroidAppDataStreamsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for ListAndroidDataStreams RPC. .. attribute:: android_app_data_streams

Results that matched the filter criteria and were accessible to the caller.

type

Sequence[google.analytics.admin_v1alpha.types.AndroidAppDataStream]

next_page_token

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

Type

str

property raw_page

class google.analytics.admin_v1alpha.types.ListConversionEventsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for ListConversionEvents RPC .. attribute:: parent

Required. The resource name of the parent property. Example: ‘properties/123’

type

str

page_size

The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200; (higher values will be coerced to the maximum)

Type

int

page_token

A page token, received from a previous ListConversionEvents call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListConversionEvents must match the call that provided the page token.

Type

str

class google.analytics.admin_v1alpha.types.ListConversionEventsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Response message for ListConversionEvents RPC. .. attribute:: conversion_events

The requested conversion events

type

Sequence[google.analytics.admin_v1alpha.types.ConversionEvent]

next_page_token

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

Type

str

property raw_page

class google.analytics.admin_v1alpha.types.ListCustomDimensionsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for ListCustomDimensions RPC. .. attribute:: parent

Required. Example format: properties/1234

type

str

page_size

The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200 (higher values will be coerced to the maximum).

Type

int

page_token

A page token, received from a previous ListCustomDimensions call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to ListCustomDimensions must match the call that provided the page token.

Type

str

class google.analytics.admin_v1alpha.types.ListCustomDimensionsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Response message for ListCustomDimensions RPC. .. attribute:: custom_dimensions

List of CustomDimensions.

type

Sequence[google.analytics.admin_v1alpha.types.CustomDimension]

next_page_token

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

Type

str

property raw_page

class google.analytics.admin_v1alpha.types.ListCustomMetricsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for ListCustomMetrics RPC. .. attribute:: parent

Required. Example format: properties/1234

type

str

page_size

The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200 (higher values will be coerced to the maximum).

Type

int

page_token

A page token, received from a previous ListCustomMetrics call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to ListCustomMetrics must match the call that provided the page token.

Type

str

class google.analytics.admin_v1alpha.types.ListCustomMetricsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Response message for ListCustomMetrics RPC. .. attribute:: custom_metrics

List of CustomMetrics.

type

Sequence[google.analytics.admin_v1alpha.types.CustomMetric]

next_page_token

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

Type

str

property raw_page

class google.analytics.admin_v1alpha.types.ListFirebaseLinksRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for ListFirebaseLinks RPC .. attribute:: parent

Required. Format: properties/{property_id} Example: properties/1234

type

str

page_size

The maximum number of resources to return. The service may return fewer than this value, even if there are additional pages. If unspecified, at most 50 resources will be returned. The maximum value is 200; (higher values will be coerced to the maximum)

Type

int

page_token

A page token, received from a previous ListFirebaseLinks call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListProperties must match the call that provided the page token.

Type

str

class google.analytics.admin_v1alpha.types.ListFirebaseLinksResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Response message for ListFirebaseLinks RPC .. attribute:: firebase_links

List of FirebaseLinks. This will have at most one value.

type

Sequence[google.analytics.admin_v1alpha.types.FirebaseLink]

next_page_token

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages. Currently, Google Analytics supports only one FirebaseLink per property, so this will never be populated.

Type

str

property raw_page

class google.analytics.admin_v1alpha.types.ListGoogleAdsLinksRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for ListGoogleAdsLinks RPC. .. attribute:: parent

Required. Example format: properties/1234

type

str

page_size

The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200 (higher values will be coerced to the maximum).

Type

int

page_token

A page token, received from a previous ListGoogleAdsLinks call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to ListGoogleAdsLinks must match the call that provided the page token.

Type

str

class google.analytics.admin_v1alpha.types.ListGoogleAdsLinksResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Response message for ListGoogleAdsLinks RPC. .. attribute:: google_ads_links

List of GoogleAdsLinks.

type

Sequence[google.analytics.admin_v1alpha.types.GoogleAdsLink]

next_page_token

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

Type

str

property raw_page

class google.analytics.admin_v1alpha.types.ListIosAppDataStreamsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for ListIosAppDataStreams RPC. .. attribute:: parent

Required. The name of the parent property. For example, to list results of app streams under the property with Id 123: “properties/123”.

type

str

page_size

The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200; (higher values will be coerced to the maximum)

Type

int

page_token

A page token, received from a previous ListIosAppDataStreams call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListIosAppDataStreams must match the call that provided the page token.

Type

str

class google.analytics.admin_v1alpha.types.ListIosAppDataStreamsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for ListIosAppDataStreams RPC. .. attribute:: ios_app_data_streams

Results that matched the filter criteria and were accessible to the caller.

type

Sequence[google.analytics.admin_v1alpha.types.IosAppDataStream]

next_page_token

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

Type

str

property raw_page

class google.analytics.admin_v1alpha.types.ListMeasurementProtocolSecretsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for ListMeasurementProtocolSecret RPC .. attribute:: parent

Required. The resource name of the parent stream. Any type of stream (WebDataStream, IosAppDataStream, AndroidAppDataStream) may be a parent. Format: properties/{property}/webDataStreams/{webDataStream}/measurementProtocolSecrets

type

str

page_size

The maximum number of resources to return. If unspecified, at most 10 resources will be returned. The maximum value is 10. Higher values will be coerced to the maximum.

Type

int

page_token

A page token, received from a previous ListMeasurementProtocolSecrets call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListMeasurementProtocolSecrets must match the call that provided the page token.

Type

str

class google.analytics.admin_v1alpha.types.ListMeasurementProtocolSecretsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Response message for ListMeasurementProtocolSecret RPC .. attribute:: measurement_protocol_secrets

A list of secrets for the parent stream specified in the request.

type

Sequence[google.analytics.admin_v1alpha.types.MeasurementProtocolSecret]

next_page_token

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

Type

str

property raw_page

class google.analytics.admin_v1alpha.types.ListPropertiesRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for ListProperties RPC. .. attribute:: filter

Required. An expression for filtering the results of the request. Fields eligible for filtering are: parent:(The resource name of the parent account) or firebase_project:(The id or number of the linked firebase project). Some examples of filters:

| Filter                      | Description                               |
|-----------------------------|-------------------------------------------|
| parent:accounts/123         | The account with account id: 123.         |
| firebase_project:project-id | The firebase project with id: project-id. |
| firebase_project:123        | The firebase project with number: 123.    |

type

str

page_size

The maximum number of resources to return. The service may return fewer than this value, even if there are additional pages. If unspecified, at most 50 resources will be returned. The maximum value is 200; (higher values will be coerced to the maximum)

Type

int

page_token

A page token, received from a previous ListProperties call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListProperties must match the call that provided the page token.

Type

str

show_deleted

Whether to include soft-deleted (ie: “trashed”) Properties in the results. Properties can be inspected to determine whether they are deleted or not.

Type

bool

class google.analytics.admin_v1alpha.types.ListPropertiesResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Response message for ListProperties RPC. .. attribute:: properties

Results that matched the filter criteria and were accessible to the caller.

type

Sequence[google.analytics.admin_v1alpha.types.Property]

next_page_token

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

Type

str

property raw_page

class google.analytics.admin_v1alpha.types.ListUserLinksRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for ListUserLinks RPC. .. attribute:: parent

Required. Example format: accounts/1234

type

str

page_size

The maximum number of user links to return. The service may return fewer than this value. If unspecified, at most 200 user links will be returned. The maximum value is 500; values above 500 will be coerced to 500.

Type

int

page_token

A page token, received from a previous ListUserLinks call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListUserLinks must match the call that provided the page token.

Type

str

class google.analytics.admin_v1alpha.types.ListUserLinksResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Response message for ListUserLinks RPC. .. attribute:: user_links

List of UserLinks. These will be ordered stably, but in an arbitrary order.

type

Sequence[google.analytics.admin_v1alpha.types.UserLink]

next_page_token

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

Type

str

property raw_page

class google.analytics.admin_v1alpha.types.ListWebDataStreamsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for ListWebDataStreams RPC. .. attribute:: parent

Required. The name of the parent property. For example, to list results of web streams under the property with Id 123: “properties/123”.

type

str

page_size

The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200; (higher values will be coerced to the maximum)

Type

int

page_token

A page token, received from a previous ListWebDataStreams call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListWebDataStreams must match the call that provided the page token.

Type

str

class google.analytics.admin_v1alpha.types.ListWebDataStreamsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for ListWebDataStreams RPC. .. attribute:: web_data_streams

Results that matched the filter criteria and were accessible to the caller.

type

Sequence[google.analytics.admin_v1alpha.types.WebDataStream]

next_page_token

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

Type

str

property raw_page

class google.analytics.admin_v1alpha.types.MaximumUserAccess(value)

Bases: proto.enums.Enum

Maximum access settings that Firebase user receive on the linked Analytics property.

EDITOR_INCLUDING_LINK_MANAGEMENT = 4

EDITOR_WITHOUT_LINK_MANAGEMENT = 3

MAXIMUM_USER_ACCESS_UNSPECIFIED = 0

NO_ACCESS = 1

READ_AND_ANALYZE = 2

class google.analytics.admin_v1alpha.types.MeasurementProtocolSecret(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A secret value used for sending hits to Measurement Protocol. .. attribute:: name

Output only. Resource name of this secret. This secret may be a child of any type of stream. Format: properties/{property}/webDataStreams/{webDataStream}/measurementProtocolSecrets/{measurementProtocolSecret}

type

str

display_name

Required. Human-readable display name for this secret.

Type

str

secret_value

Output only. The measurement protocol secret value. Pass this value to the api_secret field of the Measurement Protocol API when sending hits to this secret’s parent property.

Type

str

class google.analytics.admin_v1alpha.types.Property(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A resource message representing a Google Analytics GA4 property.

name

Output only. Resource name of this property. Format: properties/{property_id} Example: “properties/1000”.

Type

str

create_time

Output only. Time when the entity was originally created.

Type

google.protobuf.timestamp_pb2.Timestamp

update_time

Output only. Time when entity payload fields were last updated.

Type

google.protobuf.timestamp_pb2.Timestamp

parent

Immutable. Resource name of this property’s logical parent. Note: The Property-Moving UI can be used to change the parent. Format: accounts/{account} Example: “accounts/100”.

Type

str

display_name

Required. Human-readable display name for this property. The max allowed display name length is 100 UTF-16 code units.

Type

str

industry_category

Industry associated with this property Example: AUTOMOTIVE, FOOD_AND_DRINK

Type

google.analytics.admin_v1alpha.types.IndustryCategory

time_zone

Required. Reporting Time Zone, used as the day boundary for reports, regardless of where the data originates. If the time zone honors DST, Analytics will automatically adjust for the changes.

NOTE: Changing the time zone only affects data going forward, and is not applied retroactively.

Format: https://www.iana.org/time-zones Example: “America/Los_Angeles”.

Type

str

currency_code

The currency type used in reports involving monetary values.

Format: https://en.wikipedia.org/wiki/ISO_4217 Examples: “USD”, “EUR”, “JPY”.

Type

str

delete_time

Output only. If set, the time at which this property was trashed. If not set, then this property is not currently in the trash can.

Type

google.protobuf.timestamp_pb2.Timestamp

expire_time

Output only. If set, the time at which this trashed property will be permanently deleted. If not set, then this property is not currently in the trash can and is not slated to be deleted.

Type

google.protobuf.timestamp_pb2.Timestamp

class google.analytics.admin_v1alpha.types.PropertySummary(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A virtual resource representing metadata for an GA4 property. .. attribute:: property

Resource name of property referred to by this property summary Format: properties/{property_id} Example: “properties/1000”.

type

str

display_name

Display name for the property referred to in this account summary.

Type

str

class google.analytics.admin_v1alpha.types.ProvisionAccountTicketRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for ProvisionAccountTicket RPC. .. attribute:: account

The account to create.

type

google.analytics.admin_v1alpha.types.Account

redirect_uri

Redirect URI where the user will be sent after accepting Terms of Service. Must be configured in Developers Console as a Redirect URI

Type

str

class google.analytics.admin_v1alpha.types.ProvisionAccountTicketResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Response message for ProvisionAccountTicket RPC. .. attribute:: account_ticket_id

The param to be passed in the ToS link.

type

str

class google.analytics.admin_v1alpha.types.SearchChangeHistoryEventsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for SearchChangeHistoryEvents RPC. .. attribute:: account

Required. The account resource for which to return change history resources.

type

str

property

Optional. Resource name for a child property. If set, only return changes made to this property or its child resources.

Type

str

resource_type

Optional. If set, only return changes if they are for a resource that matches at least one of these types.

Type

Sequence[google.analytics.admin_v1alpha.types.ChangeHistoryResourceType]

action

Optional. If set, only return changes that match one or more of these types of actions.

Type

Sequence[google.analytics.admin_v1alpha.types.ActionType]

actor_email

Optional. If set, only return changes if they are made by a user in this list.

Type

Sequence[str]

earliest_change_time

Optional. If set, only return changes made after this time (inclusive).

Type

google.protobuf.timestamp_pb2.Timestamp

latest_change_time

Optional. If set, only return changes made before this time (inclusive).

Type

google.protobuf.timestamp_pb2.Timestamp

page_size

Optional. The maximum number of ChangeHistoryEvent items to return. The service may return fewer than this value, even if there are additional pages. If unspecified, at most 50 items will be returned. The maximum value is 200 (higher values will be coerced to the maximum).

Type

int

page_token

Optional. A page token, received from a previous SearchChangeHistoryEvents call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to SearchChangeHistoryEvents must match the call that provided the page token.

Type

str

class google.analytics.admin_v1alpha.types.SearchChangeHistoryEventsResponse(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Response message for SearchAccounts RPC. .. attribute:: change_history_events

Results that were accessible to the caller.

type

Sequence[google.analytics.admin_v1alpha.types.ChangeHistoryEvent]

next_page_token

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

Type

str

property raw_page

class google.analytics.admin_v1alpha.types.UpdateAccountRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for UpdateAccount RPC. .. attribute:: account

Required. The account to update. The account’s name field is used to identify the account.

type

google.analytics.admin_v1alpha.types.Account

update_mask

Required. The list of fields to be updated. Field names must be in snake case (e.g., “field_to_update”). Omitted fields will not be updated. To replace the entire entity, use one path with the string “*” to match all fields.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.analytics.admin_v1alpha.types.UpdateAndroidAppDataStreamRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for UpdateAndroidAppDataStream RPC. .. attribute:: android_app_data_stream

Required. The android app stream to update. The name field is used to identify the android app stream to be updated.

type

google.analytics.admin_v1alpha.types.AndroidAppDataStream

update_mask

Required. The list of fields to be updated. Field names must be in snake case (e.g., “field_to_update”). Omitted fields will not be updated. To replace the entire entity, use one path with the string “*” to match all fields.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.analytics.admin_v1alpha.types.UpdateCustomDimensionRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for UpdateCustomDimension RPC. .. attribute:: custom_dimension

The CustomDimension to update

type

google.analytics.admin_v1alpha.types.CustomDimension

update_mask

Required. The list of fields to be updated. Omitted fields will not be updated. To replace the entire entity, use one path with the string “*” to match all fields.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.analytics.admin_v1alpha.types.UpdateCustomMetricRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for UpdateCustomMetric RPC. .. attribute:: custom_metric

The CustomMetric to update

type

google.analytics.admin_v1alpha.types.CustomMetric

update_mask

Required. The list of fields to be updated. Omitted fields will not be updated. To replace the entire entity, use one path with the string “*” to match all fields.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.analytics.admin_v1alpha.types.UpdateEnhancedMeasurementSettingsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for UpdateEnhancedMeasurementSettings RPC. .. attribute:: enhanced_measurement_settings

Required. The settings to update. The name field is used to identify the settings to be updated.

type

google.analytics.admin_v1alpha.types.EnhancedMeasurementSettings

update_mask

Required. The list of fields to be updated. Field names must be in snake case (e.g., “field_to_update”). Omitted fields will not be updated. To replace the entire entity, use one path with the string “*” to match all fields.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.analytics.admin_v1alpha.types.UpdateFirebaseLinkRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for UpdateFirebaseLink RPC .. attribute:: firebase_link

Required. The Firebase link to update.

type

google.analytics.admin_v1alpha.types.FirebaseLink

update_mask

Required. The list of fields to be updated. Field names must be in snake case (e.g., “field_to_update”). Omitted fields will not be updated. To replace the entire entity, use one path with the string “*” to match all fields.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.analytics.admin_v1alpha.types.UpdateGoogleAdsLinkRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for UpdateGoogleAdsLink RPC .. attribute:: google_ads_link

The GoogleAdsLink to update

type

google.analytics.admin_v1alpha.types.GoogleAdsLink

update_mask

Required. The list of fields to be updated. Field names must be in snake case (e.g., “field_to_update”). Omitted fields will not be updated. To replace the entire entity, use one path with the string “*” to match all fields.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.analytics.admin_v1alpha.types.UpdateGoogleSignalsSettingsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for UpdateGoogleSignalsSettings RPC .. attribute:: google_signals_settings

Required. The settings to update. The name field is used to identify the settings to be updated.

type

google.analytics.admin_v1alpha.types.GoogleSignalsSettings

update_mask

Required. The list of fields to be updated. Field names must be in snake case (e.g., “field_to_update”). Omitted fields will not be updated. To replace the entire entity, use one path with the string “*” to match all fields.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.analytics.admin_v1alpha.types.UpdateIosAppDataStreamRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for UpdateIosAppDataStream RPC. .. attribute:: ios_app_data_stream

Required. The iOS app stream to update. The name field is used to identify the iOS app stream to be updated.

type

google.analytics.admin_v1alpha.types.IosAppDataStream

update_mask

Required. The list of fields to be updated. Field names must be in snake case (e.g., “field_to_update”). Omitted fields will not be updated. To replace the entire entity, use one path with the string “*” to match all fields.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.analytics.admin_v1alpha.types.UpdateMeasurementProtocolSecretRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for UpdateMeasurementProtocolSecret RPC .. attribute:: measurement_protocol_secret

Required. The measurement protocol secret to update.

type

google.analytics.admin_v1alpha.types.MeasurementProtocolSecret

update_mask

The list of fields to be updated. Omitted fields will not be updated.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.analytics.admin_v1alpha.types.UpdatePropertyRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for UpdateProperty RPC. .. attribute:: property

Required. The property to update. The property’s name field is used to identify the property to be updated.

type

google.analytics.admin_v1alpha.types.Property

update_mask

Required. The list of fields to be updated. Field names must be in snake case (e.g., “field_to_update”). Omitted fields will not be updated. To replace the entire entity, use one path with the string “*” to match all fields.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.analytics.admin_v1alpha.types.UpdateUserLinkRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for UpdateUserLink RPC. .. attribute:: user_link

Required. The user link to update.

type

google.analytics.admin_v1alpha.types.UserLink

class google.analytics.admin_v1alpha.types.UpdateWebDataStreamRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

Request message for UpdateWebDataStream RPC. .. attribute:: web_data_stream

Required. The web stream to update. The name field is used to identify the web stream to be updated.

type

google.analytics.admin_v1alpha.types.WebDataStream

update_mask

Required. The list of fields to be updated. Field names must be in snake case (e.g., “field_to_update”). Omitted fields will not be updated. To replace the entire entity, use one path with the string “*” to match all fields.

Type

google.protobuf.field_mask_pb2.FieldMask

class google.analytics.admin_v1alpha.types.UserLink(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A resource message representing a user’s permissions on an Account or Property resource.

name

Output only. Example format: properties/1234/userLinks/5678

Type

str

email_address

Immutable. Email address of the user to link

Type

str

direct_roles

Roles directly assigned to this user for this account or property.

Valid values: predefinedRoles/read predefinedRoles/collaborate predefinedRoles/edit predefinedRoles/manage-users

Excludes roles that are inherited from a higher-level entity, group, or organization admin role.

A UserLink that is updated to have an empty list of direct_roles will be deleted.

Type

Sequence[str]

class google.analytics.admin_v1alpha.types.WebDataStream(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Bases: proto.message.Message

A resource message representing a Google Analytics web stream.

name

Output only. Resource name of this Data Stream. Format: properties/{property_id}/webDataStreams/{stream_id} Example: “properties/1000/webDataStreams/2000”.

Type

str

measurement_id

Output only. Analytics “Measurement ID”, without the “G-” prefix. Example: “G-1A2BCD345E” would just be “1A2BCD345E”.

Type

str

firebase_app_id

Output only. ID of the corresponding web app in Firebase, if any. This ID can change if the web app is deleted and recreated.

Type

str

create_time

Output only. Time when this stream was originally created.

Type

google.protobuf.timestamp_pb2.Timestamp

update_time

Output only. Time when stream payload fields were last updated.

Type

google.protobuf.timestamp_pb2.Timestamp

default_uri

Immutable. Domain name of the web app being measured, or empty. Example: “http://www.google.com”, “https://www.google.com”.

Type

str

display_name

Required. Human-readable display name for the Data Stream. The max allowed display name length is 100 UTF-16 code units.

Type

str