REST Resource: properties.audienceLists

Kaynak: AudienceList

Kitle listesi, listenin oluşturulduğu sırada kitlede bulunan kullanıcıların listesidir. Bir kitlede, farklı günler için oluşturulmuş birden fazla kitle listesi olabilir.

JSON gösterimi 
{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "creationQuotaTokensCharged": integer,
  "state": enum (State),
  "beginCreatingTime": string,
  "rowCount": integer,
  "errorMessage": string,
  "percentageCompleted": number,
  "recurringAudienceList": string
}
Alanlar
name

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}
audience

string

Zorunlu. Kitle kaynağının adı. Bu kaynak adı, listelenen kitleyi tanımlar ve Analytics Verileri ve Yönetici API'leri arasında paylaşılır.

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

string

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

object (AudienceDimension)

Zorunlu. İstenen ve sorgu yanıtında gösterilen boyutlar.
creationQuotaTokensCharged

integer

Yalnızca çıkış. AudienceList oluşturulurken alınan toplam kota jetonları. Bu jeton sayısı CREATING durumundaki etkinliğe dayalı olduğundan AudienceList ACTIVE veya FAILED durumuna girdiğinde ücretlendirilen bu jetonlar sabitlenir.
state

enum (State)

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

string (Timestamp format)

Yalnızca çıkış. AudienceLists.create öğesinin çağrıldığı ve AudienceList'in CREATING durumunu başlattığı zaman.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
rowCount

integer

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

string

Yalnızca çıkış. Kitle listesi oluşturma işlemi başarısız olduğunda hata mesajı doldurulur. Böyle bir hatanın sık karşılaşılan bir nedeni kotanın tükenmesidir.
percentageCompleted

number

Yalnızca çıkış. Bu kitle dışa aktarma işlemi için tamamlanan yüzde 0 ile 100 arasındadır.
recurringAudienceList

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, ilişkili yinelenen kitle listeleri olmaz ve bu alan boş olur.

Eyalet

AudienceList şu anda bu durumda mevcut.

Sıralamalar
STATE_UNSPECIFIED Belirtilmemiş durum hiçbir zaman kullanılmaz.
CREATING AudienceList şu anda oluşturuluyor ve gelecekte kullanılabilir olacak. Oluşturma işlemi, audienceLists.create çağrısından hemen sonra gerçekleşir.
ACTIVE AudienceList eksiksiz bir şekilde oluşturuldu ve sorgulanmaya hazır. AudienceList, istekten eşzamansız olarak etkin olacak şekilde güncellenir. Bu, ilk oluşturma çağrısından bir süre sonra (örneğin 15 dakika) gerçekleşir.
FAILED AudienceList oluşturulamadı. Bu kitle listesini yeniden gönderdiğinizde başarılı sonuçlar alabilirsiniz.

Yöntemler

create

 Daha sonra alınması için bir kitle listesi oluşturur.

exportSheet

 Kullanıcıların kitle listesini bir Google E-Tablosuna aktarır.

get

 Belirli bir kitle listesiyle ilgili yapılandırma meta verilerini alır.

list

 Bir mülkün tüm kitle listelerini listeler.

query

 Kullanıcıların kitle listesini getirir.