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 |
Zorunlu. Kullanıcıların alınacağı kitle listesinin adı. Biçim: |
İstek içeriği
İstek metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{ "offset": string, "limit": string } |
Alanlar | |
---|---|
offset |
İ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 Bu sayfalandırma parametresi hakkında daha fazla bilgi edinmek için Sayfalandırma bölümüne bakın. |
limit |
İ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.
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 ( |
Alanlar | |
---|---|
spreadsheet |
Google E-Tablosunu görüntülemek için tarayıcınızda ziyaret etmeniz gereken bir URI. |
spreadsheet |
Oluşturulan Google E-Tablosu kaynağını tanımlayan kimlik. |
row |
AudienceList sonucundaki toplam satır sayısı. Bu sayfalandırma parametresi hakkında daha fazla bilgi edinmek için Sayfalandırma bölümüne bakın. |
audience |
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 |
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