REST Resource: properties.audienceLists

Resource: AudienceList

An audience list is a list of users in an audience at the time of the list's creation. One audience may have multiple audience lists created for different days.

JSON representation 
{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "creationQuotaTokensCharged": integer,
  "state": enum (State),
  "beginCreatingTime": string,
  "rowCount": integer,
  "errorMessage": string
}
Fields
name

string

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

Format: properties/{property}/audienceLists/{audienceList}
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}
audienceDisplayName

string

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

object (AudienceDimension)

Required. The dimensions requested and displayed in the report response.
creationQuotaTokensCharged

integer

Output only. The total quota tokens charged during creation of the AudienceList. Because this token count is based on activity from the CREATING state, this tokens charged will be fixed once an AudienceList enters the ACTIVE or FAILED states.
state

enum (State)

Output only. The current state for this AudienceList.
beginCreatingTime

string (Timestamp format)

Output only. The time when audienceLists.create was called and the AudienceList began the CREATING state.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
rowCount

integer

Output only. The total number of rows in the AudienceList result.
errorMessage

string

Output only. Error message is populated when an audience list fails during creation. A common reason for such a failure is quota exhaustion.

AudienceDimension

An audience dimension is a user attribute. Specific user attributed are requested and then later returned in the QueryAudienceListResponse.

JSON representation 
{
  "dimensionName": string
}
Fields
dimensionName

string

Optional. The API name of the dimension. See the API Dimensions for the list of dimension names.

State

The AudienceList currently exists in this state.

Enums
STATE_UNSPECIFIED Unspecified state will never be used.
CREATING The AudienceList is currently creating and will be available in the future. Creating occurs immediately after the audienceLists.create call.
ACTIVE The AudienceList is fully created and ready for querying. An AudienceList is updated to active asynchronously from a request; this occurs some time (for example 15 minutes) after the initial create call.
FAILED The AudienceList failed to be created. It is possible that re-requesting this audience list will succeed.

Methods

create

 Creates an audience list for later retrieval.

exportSheet

 Exports an audience list of users to a Google Sheet.

get

 Gets configuration metadata about a specific audience list.

list

 Lists all audience lists for a property.

query

 Retrieves an audience list of users.