Google Analytics Data V1alpha Client - Class RecurringAudienceList (0.14.0)

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 message google.analytics.data.v1alpha.RecurringAudienceList

Namespace

Google \ Analytics \ Data \ V1alpha

Methods

__construct

Constructor.

Parameters
NameDescription
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 this RecurringAudienceList. 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".

↳ dimensions array<Google\Analytics\Data\V1alpha\AudienceDimension>

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.

getName

Output only. Identifier. The recurring audience list resource name assigned during creation. This resource name identifies this RecurringAudienceList.

Format: properties/{property}/recurringAudienceLists/{recurring_audience_list}

Returns
TypeDescription
string

setName

Output only. Identifier. The recurring audience list resource name assigned during creation. This resource name identifies this RecurringAudienceList.

Format: properties/{property}/recurringAudienceLists/{recurring_audience_list}

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getAudience

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}

Returns
TypeDescription
string

setAudience

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}

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getAudienceDisplayName

Output only. The descriptive display name for this audience. For example, "Purchasers".

Returns
TypeDescription
string

setAudienceDisplayName

Output only. The descriptive display name for this audience. For example, "Purchasers".

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getDimensions

Required. The dimensions requested and displayed in the audience list response.

Returns
TypeDescription
Google\Protobuf\Internal\RepeatedField

setDimensions

Required. The dimensions requested and displayed in the audience list response.

Parameter
NameDescription
var array<Google\Analytics\Data\V1alpha\AudienceDimension>
Returns
TypeDescription
$this

getActiveDaysRemaining

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
TypeDescription
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
NameDescription
var int
Returns
TypeDescription
$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.

Returns
TypeDescription
Google\Protobuf\Internal\RepeatedField

setAudienceLists

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
NameDescription
var string[]
Returns
TypeDescription
$this