Reference documentation and code samples for the Google Analytics Data V1alpha Client class RecurringAudienceList.
A recurring audience list produces new audience lists each day. Audience
lists are users in an audience at the time of the list's creation. A
recurring audience list ensures that you have audience list based on the most
recent data available for use each day.
Generated from protobuf messagegoogle.analytics.data.v1alpha.RecurringAudienceList
Namespace
Google \ Analytics \ Data \ V1alpha
Methods
__construct
Constructor.
Parameters
Name
Description
data
array
Optional. Data for populating the Message object.
↳ name
string
Output only. Identifier. The recurring audience list resource name assigned during creation. This resource name identifies thisRecurringAudienceList. Format:properties/{property}/recurringAudienceLists/{recurring_audience_list}
↳ audience
string
Required. The audience resource name. This resource name identifies the audience being listed and is shared between the Analytics Data & Admin APIs. Format:properties/{property}/audiences/{audience}
↳ audience_display_name
string
Output only. The descriptive display name for this audience. For example, "Purchasers".
Required. The dimensions requested and displayed in the audience list response.
↳ active_days_remaining
int
Optional. The number of remaining days that a recurring audience export will produce an audience list instance. This counter decreases by one each day, and when it reaches zero, no new audience lists will be created. Recurring audience list request for Analytics 360 properties default to 180 days and have a maximum of 365 days. Requests for standard Analytics properties default to 14 days and have a maximum of 30 days. The minimum value allowed during creation is 1. Requests above their respective maximum will be coerced to their maximum.
↳ audience_lists
array
Output only. Audience list resource names for audience list instances created for this recurring audience list. One audience list is created for each day, and the audience list will be listed here. This list is ordered with the most recently created audience list first.
Optional. Configures webhook notifications to be sent from the Google Analytics Data API to your webhook server. Use of webhooks is optional. If unused, you'll need to poll this API to determine when a recurring audience list creates new audience lists. Webhooks allow a notification to be sent to your servers & avoid the need for polling. Two POST requests will be sent each time a recurring audience list creates an audience list. This happens once per day until a recurring audience list reaches 0 active days remaining. The first request will be sent showing a newly created audience list in its CREATING state. The second request will be sent after the audience list completes creation (either the ACTIVE or FAILED state).
getName
Output only. Identifier. The recurring audience list resource name assigned
during creation. This resource name identifies thisRecurringAudienceList.
Optional. The number of remaining days that a recurring audience export
will produce an audience list instance. This counter decreases by one each
day, and when it reaches zero, no new audience lists will be created.
Recurring audience list request for Analytics 360 properties default to 180
days and have a maximum of 365 days. Requests for standard Analytics
properties default to 14 days and have a maximum of 30 days.
The minimum value allowed during creation is 1. Requests above their
respective maximum will be coerced to their maximum.
Returns
Type
Description
int
hasActiveDaysRemaining
clearActiveDaysRemaining
setActiveDaysRemaining
Optional. The number of remaining days that a recurring audience export
will produce an audience list instance. This counter decreases by one each
day, and when it reaches zero, no new audience lists will be created.
Recurring audience list request for Analytics 360 properties default to 180
days and have a maximum of 365 days. Requests for standard Analytics
properties default to 14 days and have a maximum of 30 days.
The minimum value allowed during creation is 1. Requests above their
respective maximum will be coerced to their maximum.
Parameter
Name
Description
var
int
Returns
Type
Description
$this
getAudienceLists
Output only. Audience list resource names for audience list instances
created for this recurring audience list. One audience list is created for
each day, and the audience list will be listed here.
This list is ordered with the most recently created audience list first.
Output only. Audience list resource names for audience list instances
created for this recurring audience list. One audience list is created for
each day, and the audience list will be listed here.
This list is ordered with the most recently created audience list first.
Parameter
Name
Description
var
string[]
Returns
Type
Description
$this
getWebhookNotification
Optional. Configures webhook notifications to be sent from the Google
Analytics Data API to your webhook server. Use of webhooks is optional. If
unused, you'll need to poll this API to determine when a recurring audience
list creates new audience lists. Webhooks allow a notification to be sent
to your servers & avoid the need for polling.
Two POST requests will be sent each time a recurring audience list creates
an audience list. This happens once per day until a recurring audience list
reaches 0 active days remaining. The first request will be sent showing a
newly created audience list in its CREATING state. The second request will
be sent after the audience list completes creation (either the ACTIVE or
FAILED state).
Optional. Configures webhook notifications to be sent from the Google
Analytics Data API to your webhook server. Use of webhooks is optional. If
unused, you'll need to poll this API to determine when a recurring audience
list creates new audience lists. Webhooks allow a notification to be sent
to your servers & avoid the need for polling.
Two POST requests will be sent each time a recurring audience list creates
an audience list. This happens once per day until a recurring audience list
reaches 0 active days remaining. The first request will be sent showing a
newly created audience list in its CREATING state. The second request will
be sent after the audience list completes creation (either the ACTIVE or
FAILED state).
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Google Analytics Data V1alpha Client - Class RecurringAudienceList (0.22.3)\n\nVersion latestkeyboard_arrow_down\n\n- [0.22.3 (latest)](/php/docs/reference/analytics-data/latest/V1alpha.RecurringAudienceList)\n- [0.22.2](/php/docs/reference/analytics-data/0.22.2/V1alpha.RecurringAudienceList)\n- [0.21.1](/php/docs/reference/analytics-data/0.21.1/V1alpha.RecurringAudienceList)\n- [0.20.1](/php/docs/reference/analytics-data/0.20.1/V1alpha.RecurringAudienceList)\n- [0.19.0](/php/docs/reference/analytics-data/0.19.0/V1alpha.RecurringAudienceList)\n- [0.18.0](/php/docs/reference/analytics-data/0.18.0/V1alpha.RecurringAudienceList)\n- [0.17.1](/php/docs/reference/analytics-data/0.17.1/V1alpha.RecurringAudienceList)\n- [0.16.4](/php/docs/reference/analytics-data/0.16.4/V1alpha.RecurringAudienceList)\n- [0.14.0](/php/docs/reference/analytics-data/0.14.0/V1alpha.RecurringAudienceList)\n- [0.13.0](/php/docs/reference/analytics-data/0.13.0/V1alpha.RecurringAudienceList)\n- [0.12.0](/php/docs/reference/analytics-data/0.12.0/V1alpha.RecurringAudienceList)\n- [0.11.2](/php/docs/reference/analytics-data/0.11.2/V1alpha.RecurringAudienceList)\n- [0.10.1](/php/docs/reference/analytics-data/0.10.1/V1alpha.RecurringAudienceList)\n- [0.9.5](/php/docs/reference/analytics-data/0.9.5/V1alpha.RecurringAudienceList) \n| **Beta**\n|\n|\n| This library is covered by the [Pre-GA Offerings Terms](/terms/service-terms#1)\n| of the Terms of Service. Pre-GA libraries might have limited support,\n| and changes to pre-GA libraries might not be compatible with other pre-GA versions.\n| For more information, see the\n[launch stage descriptions](/products#product-launch-stages). \nReference documentation and code samples for the Google Analytics Data V1alpha Client class RecurringAudienceList.\n\nA recurring audience list produces new audience lists each day. Audience\nlists are users in an audience at the time of the list's creation. A\nrecurring audience list ensures that you have audience list based on the most\nrecent data available for use each day.\n\nGenerated from protobuf message `google.analytics.data.v1alpha.RecurringAudienceList`\n\nNamespace\n---------\n\nGoogle \\\\ Analytics \\\\ Data \\\\ V1alpha\n\nMethods\n-------\n\n### __construct\n\nConstructor.\n\n### getName\n\nOutput only. Identifier. The recurring audience list resource name assigned\nduring creation. This resource name identifies this\n`RecurringAudienceList`.\n\nFormat:\n`properties/{property}/recurringAudienceLists/{recurring_audience_list}`\n\n### setName\n\nOutput only. Identifier. The recurring audience list resource name assigned\nduring creation. This resource name identifies this\n`RecurringAudienceList`.\n\nFormat:\n`properties/{property}/recurringAudienceLists/{recurring_audience_list}`\n\n### getAudience\n\nRequired. The audience resource name. This resource name identifies the\naudience being listed and is shared between the Analytics Data \\& Admin\nAPIs.\n\nFormat: `properties/{property}/audiences/{audience}`\n\n### setAudience\n\nRequired. The audience resource name. This resource name identifies the\naudience being listed and is shared between the Analytics Data \\& Admin\nAPIs.\n\nFormat: `properties/{property}/audiences/{audience}`\n\n### getAudienceDisplayName\n\nOutput only. The descriptive display name for this audience. For example,\n\"Purchasers\".\n\n### setAudienceDisplayName\n\nOutput only. The descriptive display name for this audience. For example,\n\"Purchasers\".\n\n### getDimensions\n\nRequired. The dimensions requested and displayed in the audience list\nresponse.\n\n### setDimensions\n\nRequired. The dimensions requested and displayed in the audience list\nresponse.\n\n### getActiveDaysRemaining\n\nOptional. The number of remaining days that a recurring audience export\nwill produce an audience list instance. This counter decreases by one each\nday, and when it reaches zero, no new audience lists will be created.\n\nRecurring audience list request for Analytics 360 properties default to 180\ndays and have a maximum of 365 days. Requests for standard Analytics\nproperties default to 14 days and have a maximum of 30 days.\nThe minimum value allowed during creation is 1. Requests above their\nrespective maximum will be coerced to their maximum.\n\n### hasActiveDaysRemaining\n\n### clearActiveDaysRemaining\n\n### setActiveDaysRemaining\n\nOptional. The number of remaining days that a recurring audience export\nwill produce an audience list instance. This counter decreases by one each\nday, and when it reaches zero, no new audience lists will be created.\n\nRecurring audience list request for Analytics 360 properties default to 180\ndays and have a maximum of 365 days. Requests for standard Analytics\nproperties default to 14 days and have a maximum of 30 days.\nThe minimum value allowed during creation is 1. Requests above their\nrespective maximum will be coerced to their maximum.\n\n### getAudienceLists\n\nOutput only. Audience list resource names for audience list instances\ncreated for this recurring audience list. One audience list is created for\neach day, and the audience list will be listed here.\n\nThis list is ordered with the most recently created audience list first.\n\n### setAudienceLists\n\nOutput only. Audience list resource names for audience list instances\ncreated for this recurring audience list. One audience list is created for\neach day, and the audience list will be listed here.\n\nThis list is ordered with the most recently created audience list first.\n\n### getWebhookNotification\n\nOptional. Configures webhook notifications to be sent from the Google\nAnalytics Data API to your webhook server. Use of webhooks is optional. If\nunused, you'll need to poll this API to determine when a recurring audience\nlist creates new audience lists. Webhooks allow a notification to be sent\nto your servers \\& avoid the need for polling.\n\nTwo POST requests will be sent each time a recurring audience list creates\nan audience list. This happens once per day until a recurring audience list\nreaches 0 active days remaining. The first request will be sent showing a\nnewly created audience list in its CREATING state. The second request will\nbe sent after the audience list completes creation (either the ACTIVE or\nFAILED state).\n\n### hasWebhookNotification\n\n### clearWebhookNotification\n\n### setWebhookNotification\n\nOptional. Configures webhook notifications to be sent from the Google\nAnalytics Data API to your webhook server. Use of webhooks is optional. If\nunused, you'll need to poll this API to determine when a recurring audience\nlist creates new audience lists. Webhooks allow a notification to be sent\nto your servers \\& avoid the need for polling.\n\nTwo POST requests will be sent each time a recurring audience list creates\nan audience list. This happens once per day until a recurring audience list\nreaches 0 active days remaining. The first request will be sent showing a\nnewly created audience list in its CREATING state. The second request will\nbe sent after the audience list completes creation (either the ACTIVE or\nFAILED state)."]]