REST Resource: properties.audienceLists

{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "creationQuotaTokensCharged": integer,
  "state": enum (State),
  "beginCreatingTime": string,
  "rowCount": integer,
  "errorMessage": string,
  "percentageCompleted": number,
  "recurringAudienceList": string,
  "webhookNotification": {
    object (WebhookNotification)
  }
}

string

Yalnızca çıkış. Tanımlayıcı. Oluşturma sırasında atanan kitle listesi kaynak adı. Bu kaynak adı, bu AudienceList öğesini tanımlar.

Biçim: properties/{property}/audienceLists/{audienceList}

string

Zorunlu. Kitle kaynağının adı. Bu kaynak adı, listelenen kitleyi tanımlar ve Analytics Verileri ile Yönetici API'leri.

Biçim: properties/{property}/audiences/{audience}

string

Yalnızca çıkış. Bu kitle için açıklayıcı görünen ad. Örneğin, "Alıcılar".

object (AudienceDimension)

Zorunlu. Sorgu yanıtında istenen ve görüntülenen boyutlar.

integer

Yalnızca çıkış. AudienceList oluşturulurken ücretlendirilen toplam kota jetonları. Bu jeton sayısı CREATING durumundaki etkinliğe dayandığından, bir AudienceList ACTIVE veya FAILED durumları ulaştığında, jetondan alınan bu jeton ücreti sabitlenir.

enum (State)

Yalnızca çıkış. Bu AudienceList için mevcut durum.

string (Timestamp format)

Yalnızca çıkış. audienceLists.create çağrıldığı ve AudienceList'in CREATING durumunun başladığı zaman.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

integer

Yalnızca çıkış. AudienceList sonucundaki toplam satır sayısı.

string

Yalnızca çıkış. Kitle listesi, oluşturma işlemi sırasında başarısız olursa hata mesajı doldurulur. Bu tür hataların yaygın bir nedeni kotanın tükenmesidir.

number

Yalnızca çıkış. 0 ile 100 arasında değişen bu kitle dışa aktarma işlemi için tamamlanan yüzde.

string

Yalnızca çıkış. Bu kitle listesini oluşturan yinelenen kitle listesi. Yinelenen kitle listeleri günlük olarak kitle listeleri oluşturur.

Kitle listeleri doğrudan oluşturulursa bunların ilişkilendirilmiş yinelenen kitle listesi olmaz ve bu alan boş olur.

object (WebhookNotification)

İsteğe bağlı. Google Analytics Data API'den webhook sunucunuza gönderilecek web kancası bildirimlerini yapılandırır. Webhook kullanımı isteğe bağlıdır. Kullanılmayan kitle listesinin ne zaman kullanıma hazır olduğunu belirlemek için bu API'yi yoklamanız gerekir. Webhook'lar, sunucularınıza bildirim gönderilmesine ve anket yapmak zorunda kalmayacaksınız.

Webhook'a bir veya iki POST isteği gönderilir. Yeni oluşturulan kitle listesini CREATING durumunda gösteren ilk POST isteği hemen gönderilir. İkinci POST isteği, kitle listesi oluşturma işlemini tamamladıktan sonra gönderilir (ETKİN veya BAŞARISIZ durumu).

Özdeş kitle listeleri hızlı bir şekilde arka arkaya istenirse, ikinci ve sonraki kitle listeleri önbellekten sunulabilir. Bu durumda, kitle listesi oluşturma yöntemi bir kitle listesini zaten ETKİN olarak döndürebilir. Bu senaryoda webhook'a yalnızca bir POST isteği gönderilir.