Method: properties.audienceLists.exportSheet

Kullanıcı kitle listesini bir Google E-Tablosu'na aktarır. Kitle oluşturulduktan sonra kullanıcılar listelenmeye hemen uygun olmaz. Öncelikle, kullanıcıların kitle listesini oluşturmak için audienceLists.create isteğinde bulunmak gerekir. İkinci olarak, bu yöntem kitle listesindeki bu kullanıcıları bir Google E-Tablosu'na aktarmak için 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 için önemli olan şekillerde segmentlere ayırmanızı sağlar. Daha fazla bilgi için https://support.google.com/analytics/answer/9267572 adresini inceleyin.

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 ile ilgili 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

İsteğin gövdesi, aşağıdaki yapıya sahip veriler 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ıdır. İ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 değerine ayarlar; ilk istek satırların ilk limit değerini döndürür. İkinci istek, ofseti ilk isteğin limit değerine 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 Sayfaları numaralandırma konusuna bakın.
limit

string (int64 format)

İsteğe bağlı. Döndürülecek satır sayısı. Belirtilmemesi halinde 10.000 satır döndürülür. API, kaç tane istediğinize bakılmaksızın istek başına maksimum 250.000 satır döndürür. limit pozitif olmalıdır.

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

Bu sayfalara ayırma parametresi hakkında daha fazla bilgi için Sayfaları numaralandırma konusuna 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-Tablo kaynağını tanımlayan bir 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ğine limit/50 satırı dahil ediyorsa yanıt, 175 satırdan rowCount tanesini ancak 50 satırı içerir.

Bu sayfalara ayırma parametresi hakkında daha fazla bilgi için Sayfaları numaralandırma konusuna bakın.
audienceList

object (AudienceList)

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

Örneğin, AudienceList'te Google E-Tablosu'nda bulunandan daha fazla satır olabilir. Bu durumda, ek bir Google E-Tablosunda sonraki satır sayfasını almak için farklı bir offset değeriyle 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