Method: properties.audienceLists.exportSheet

Kullanıcılardan oluşan bir kitle listesini Google E-Tablosu'na aktarır. Bir kitle oluşturulduktan sonra kullanıcılar hemen listelenemez. Öncelikle, kullanıcıların kitle listesini oluşturmak için audienceLists.create isteğinde bulunulması gerekir. Ardından, bu yöntem kitle listesindeki kullanıcıları bir Google E-Tablosu'na aktarmak için kullanılır.

Kitle listelerine örneklerle giriş için Kitle listesi oluşturma başlıklı makaleyi inceleyin.

Google Analytics 4'teki kitleler, kullanıcılarınızı işletmeniz için önemli olan şekillerde segmentlere ayırmanıza olanak tanır. 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 Bildirimi 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 metni aşağıdaki yapıyla birlikte 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.

Sayfalandırmada ilk istek, ofseti belirtmez veya eşdeğer olarak ofseti 0 olarak ayarlar. İlk istek, ilk limit satırı döndürür. İkinci istek, ofseti ilk isteğinin limit değerine ayarlar; ikinci istek, satırların ikinci limit değerini döndürür.

Bu sayfalandırma parametresi hakkında daha fazla bilgi edinmek için Sayfalandırma bölümüne bakın.

limit

string (int64 format)

İsteğe bağlı. Döndürülecek satır sayısı. Belirtilmemişse 10.000 satır döndürülür. API, kaç tane isterseniz isteyin istek başına en fazla 250.000 satır döndürür. limit pozitif olmalıdır.

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

Bu sayfalandırma parametresi hakkında daha fazla bilgi edinmek için Sayfalandırma bölümüne bakın.

Yanıt gövdesi

Bir 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 etmeniz gereken bir URI.

spreadsheetId

string

Oluşturulan Google E-Tablosu 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ı, limit istek parametresi ve offset istek parametresinden bağımsızdır. Örneğin, bir sorgu 175 satır döndürüyorsa ve API isteğinde 50 tane limit içeriyorsa yanıtta 175 tane rowCount bulunur ancak yalnızca 50 satır vardır.

Bu sayfalandırma parametresi hakkında daha fazla bilgi edinmek için Sayfalandırma bölümüne bakın.

audienceList

object (AudienceList)

AudienceList ile ilgili yapılandırma verileri dışa aktarılıyor. Bu yanıtın Google E-Tablosu'ndaki AudienceList öğesinin yorumlanmasına yardımcı olmak için döndürülür.

Örneğin, AudienceList, Google E-Tablosundakinden daha fazla satıra sahip olabilir. Bu durumda, ek bir Google E-Tablosunda satırların bir sonraki sayfasını almak için farklı bir offset değeri içeren ek bir e-tablo dışa aktarma isteği gönderebilirsiniz.

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