Method: properties.conversionEvents.list

  • This page details how to retrieve a list of conversion events within a specified Google Analytics 4 property using the conversionEvents.list method.

  • The request requires the parent property ID and accepts optional pageSize and pageToken parameters for pagination.

  • The response includes an array of conversionEvents objects and a nextPageToken if additional pages are available.

  • Proper authorization with either analytics.readonly or analytics.edit scope is necessary to access this functionality.

Deprecated: Use ListKeyEvents instead. Returns a list of conversion events in the specified parent property.

Returns an empty list if no conversion events are found.

HTTP request

GET https://analyticsadmin.googleapis.com/v1beta/{parent=properties/*}/conversionEvents

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

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

Query parameters

Parameters
pageSize

integer

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)
pageToken

string

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

Request body

The request body must be empty.

Response body

Response message for conversionEvents.list RPC.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "conversionEvents": [
    {
      object (ConversionEvent)
    }
  ],
  "nextPageToken": string
}
Fields
conversionEvents[]

object (ConversionEvent)

The requested conversion events
nextPageToken

string

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

Authorization scopes

Requires one of the following OAuth scopes:

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