Method: properties.audienceLists.exportSheet

Kullanıcıların yer aldığı kitle listesini Google E-Tablosu'na aktarır. Kitle oluşturulduktan sonra, kullanıcılar listeleme için hemen kullanılamaz. İlk olarak, kullanıcılardan oluşan bir kitle listesi oluşturmak için audienceLists.create isteği gerekir. İkinci olarak, kitle listesindeki bu kullanıcıları bir Google E-Tablosu'na aktarmak için bu yöntem kullanılır.

Örnekler içeren Kitle Listelerine giriş için Kitle Listesi Oluşturma bölümüne bakın.

Google Analytics 4'teki kitleler, kullanıcılarınızı işletmeniz açısından önem taşıyan ölçütlere göre segmentlere ayırmanızı sağlar. Daha fazla bilgi için https://support.google.com/analytics/answer/9267572 adresini ziyaret edin.

Bu yöntem, beta sürüme geçmeden önce söz dizimi ve özelliklerle ilgili geri bildirim toplamak amacıyla alfa kararlılığında kullanıma sunulmuştur. Bu API hakkında geri bildirimde bulunmak için Google Analytics Audience Export API Geri Bildirim formunu doldurun.

HTTP isteği

POST https://analyticsdata.googleapis.com/v1alpha/{name=properties/*/audienceLists/*}:exportSheet

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
name

string

Zorunlu. Kullanıcıların alınacağı kitle listesinin adı. Biçim: properties/{property}/audienceLists/{audienceList}

İstek içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi 
{
  "offset": string,
  "limit": string
}
Alanlar
offset

string (int64 format)

İsteğe bağlı. Başlangıç satırının satır sayısı. İlk satır, 0. satır olarak sayılır.

Sayfalara ayırma sırasında ilk istek ofseti belirtmez; veya eşdeğer olarak, ofseti 0'a ayarlar; ilk istek, satırların ilk limit tanesini döndürür. İkinci istek, ilk isteğin limit farkını ayarlar; ikinci istek, satırların ikinci limit değerini döndürür.

Bu sayfalara ayırma parametresi hakkında daha fazla bilgi için Sayfalara ayırma bölümüne bakın.
limit

string (int64 format)

İsteğe bağlı. Döndürülecek satır sayısı. Belirtilmezse 10.000 satır döndürülür. API, istediğiniz sayıda satırdan bağımsız olarak istek başına en fazla 250.000 satır döndürür. limit pozitif olmalıdır.

Ayrıca, limit kadar boyut değeri yoksa API, istenen limit değerinden daha az satır döndürebilir.

Bu sayfalara ayırma parametresi hakkında daha fazla bilgi için Sayfalara ayırma bölümüne bakın.

Yanıt gövdesi

Kitle listesindeki kullanıcıların listesini içeren, oluşturulan Google E-Tablosu.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "spreadsheetUri": string,
  "spreadsheetId": string,
  "rowCount": integer,
  "audienceList": {
    object (AudienceList)
  }
}
Alanlar
spreadsheetUri

string

Google E-Tablosunu görüntülemek için tarayıcınızda ziyaret edebileceğiniz bir URI.
spreadsheetId

string

Oluşturulan Google E-Tablolar kaynağını tanımlayan kimlik.
rowCount

integer

AudienceList sonucundaki toplam satır sayısı. rowCount, yanıtta döndürülen satır sayısından, limit istek parametresinden ve offset istek parametresinden bağımsızdır. Örneğin, bir sorgu 175 satır döndürüyorsa ve API isteğinde 50 satırdan limit tanesini içeriyorsa yanıt, 175 satırdan rowCount tanesini, ancak yalnızca 50 satırı içerecek.

Bu sayfalara ayırma parametresi hakkında daha fazla bilgi için Sayfalara ayırma bölümüne bakın.
audienceList

object (AudienceList)

Dışa aktarılan AudienceList ile ilgili yapılandırma verileri. Bu yanıtın Google E-Tablosu'ndaki AudienceList bölümünü yorumlamaya yardımcı olmak için geri döndü.

Örneğin AudienceList, Google E-Tablosu'nda bulunandan daha fazla satıra sahip olabilir. Bu durumda, ek bir Google E-Tablosundaki satırların sonraki sayfasını almak için farklı offset değerine sahip ek bir e-tablo dışa aktarma isteği göndermek isteyebilirsiniz.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets