REST Resource: properties.recurringAudienceLists

Recurso: RecurringAudienceList

Una lista de público recurrente genera listas de público nuevas todos los días. Las listas de público son usuarios de un público al momento de la creación de la lista. Una lista de público recurrente garantiza que tenga una lista de público basada en los datos más recientes disponibles para usar cada día.

Representación JSON 
{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "audienceLists": [
    string
  ],
  "activeDaysRemaining": integer,
  "webhookNotification": {
    object (WebhookNotification)
  }
}
Campos
name

string

Solo salida. Identificador. El nombre del recurso de la lista de público recurrente asignado durante la creación. El nombre de este recurso identifica este RecurringAudienceList.

Formato: properties/{property}/recurringAudienceLists/{recurringAudienceList}
audience

string

Obligatorio. Es el nombre del recurso del público. El nombre de este recurso identifica el público que se muestra en la lista y se comparte entre las APIs de Analytics Data & Admin.

Formato: properties/{property}/audiences/{audience}
audienceDisplayName

string

Solo salida. Es el nombre visible descriptivo para este público. Por ejemplo, "Compradores".
dimensions[]

object (AudienceDimension)

Obligatorio. Son las dimensiones solicitadas y que se muestran en la respuesta de la lista de público.
audienceLists[]

string

Solo salida. Nombres de los recursos de listas de público para las instancias de listas de público creadas para esta lista de público recurrente. Se crea una lista de público para cada día, y la lista de público se incluirá aquí.

Esta lista se ordena con la lista de público creada más recientemente.
activeDaysRemaining

integer

Opcional. La cantidad de días restantes durante los que una exportación de público recurrente producirá una instancia de lista de público. Este contador disminuye en uno por día y, cuando llega a cero, no se crearán nuevas listas de público.

Las solicitudes de listas de público recurrentes para las propiedades de Analytics 360 se establecen de forma predeterminada en 180 días, con un máximo de 365 días. Las solicitudes de propiedades de Analytics estándares tienen un período de 14 días de forma predeterminada, y un máximo de 30 días.

El valor mínimo permitido durante la creación es 1. Las solicitudes que superen el máximo correspondiente se forzarán a su máximo.
webhookNotification

object (WebhookNotification)

Opcional. Configura las notificaciones de webhook que se enviarán desde la API de datos de Google Analytics a su servidor de webhook. El uso de webhooks es opcional. Si no se utiliza, deberá consultar esta API para determinar cuándo una lista de público recurrente crea nuevas listas de público. Los webhooks permiten que se envíe una notificación a tus servidores y evitan que se usen sondeos.

Se enviarán dos solicitudes POST cada vez que una lista de público recurrente cree una. Esto sucede una vez al día hasta que una lista de público recurrente no supere los 0 días activos restantes. La primera solicitud se enviará con una lista de público recién creada en su estado CREATING. La segunda solicitud se enviará después de que se complete la creación de la lista de público (ya sea con el estado ACTIVO o CON ERRORES).

Métodos

create

 Crea una lista de público recurrente.

get

 Obtiene metadatos de configuración sobre una lista de público recurrente específica.

list

 Muestra una lista de todas las listas de público recurrentes de una propiedad.