Kaynak: AudienceList
Kitle listesi, listenin oluşturulduğu sırada kitlede bulunan kullanıcıların listesidir. Bir kitlenin farklı günler için oluşturulmuş birden fazla kitle listesi olabilir.
JSON gösterimi |
---|
{ "name": string, "audience": string, "audienceDisplayName": string, "dimensions": [ { object ( |
Alanlar | |
---|---|
name |
Yalnızca çıkış. Tanımlayıcı. Oluşturma sırasında atanan kitle listesi kaynak adı. Bu kaynak adı, bu Biçim: |
audience |
Zorunlu. Kitle kaynağının adı. Bu kaynak adı, listelenmekte olan kitleyi tanımlar ve Analytics Verileri ile Yönetici API'leri arasında paylaşılır. Biçim: |
audienceDisplayName |
Yalnızca çıkış. Bu kitle için açıklayıcı bir görünen ad. Örneğin, "Alıcılar". |
dimensions[] |
Zorunlu. Sorgu yanıtında istenen ve gösterilen boyutlar. |
creationQuotaTokensCharged |
Yalnızca çıkış. AudienceList oluşturulurken alınan toplam kota jetonları. Bu jeton sayısı |
state |
Yalnızca çıkış. Bu Kitle Listesi için mevcut durum. |
beginCreatingTime |
Yalnızca çıkış. AudienceLists.create değerinin çağrıldığı ve AudienceList'in Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
rowCount |
Yalnızca çıkış. AudienceList sonucundaki toplam satır sayısı. |
errorMessage |
Yalnızca çıkış. Kitle listesi oluşturma işlemi başarısız olduğunda hata mesajı doldurulur. Bu başarısızlığın yaygın bir nedeni kotanın tükenmesidir. |
percentageCompleted |
Yalnızca çıkış. Bu kitle dışa aktarma işlemi için tamamlanan yüzde 0 ile 100 arasındadır. |
recurringAudienceList |
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, ilişkili yinelenen kitle listeleri olmaz ve bu alan boş olur. |
webhookNotification |
İsteğe bağlı. Google Analytics Data API'den webhook sunucunuza gönderilecek webhook bildirimlerini yapılandırır. Webhook kullanımı isteğe bağlıdır. Kullanılmayan kitle listelerinin 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 olanak tanır ve yoklama ihtiyacını ortadan kaldırır. Webhook'a bir veya iki POST isteği gönderilir. Yeni oluşturulan kitle listesini CREATING durumunda gösterecek şekilde ilk POST isteği hemen gönderilir. İkinci POST isteği, kitle listesinin oluşturulması tamamlandıktan sonra gönderilir (ETKİN veya BAŞARISIZ durumu). Hızlı bir şekilde arka arkaya benzer kitle listeleri istenirse ikinci ve sonraki kitle listeleri önbellekten sunulabilir. Bu durumda, kitle listesi oluşturma yöntemi zaten ETKİN olan bir kitle listesi döndürebilir. Bu senaryoda webhook'a yalnızca bir POST isteği gönderilir. |
Eyalet
AudienceList şu anda bu durumda bulunmaktadır.
Sıralamalar | |
---|---|
STATE_UNSPECIFIED |
Belirtilmemiş durum hiçbir zaman kullanılmaz. |
CREATING |
AudienceList şu anda oluşturuluyor ve gelecekte kullanılabilir. Oluşturma, audienceLists.create çağrısından hemen sonra gerçekleşir. |
ACTIVE |
AudienceList tamamen oluşturuldu ve sorgulanmaya hazır. AudienceList, istekten eşzamansız olarak etkin olacak şekilde güncellenir. Bu durum, ilk create çağrısından bir süre sonra (örneğin 15 dakika) gerçekleşir. |
FAILED |
AudienceList oluşturulamadı. Bu kitle listesini yeniden isteme işlemi başarılı olabilir. |
Yöntemler |
|
---|---|
|
Daha sonra almak üzere bir kitle listesi oluşturur. |
|
Kullanıcı kitle listesini bir Google E-Tablosu'na aktarır. |
|
Belirli bir kitle listesiyle ilgili yapılandırma meta verilerini alır. |
|
Bir mülk için tüm kitle listelerini listeler. |
|
Kullanıcıların kitle listesini alır. |