Method: properties.audienceExports.query

Kullanıcıların kitle dışa aktarma işlemini alır. Kitle oluşturulduktan sonra kullanıcılar hemen dışa aktarılamaz. Öncelikle, kullanıcıların kitle dışa aktarımını oluşturmak için audienceExports.create isteği gerekir. Ardından, bu yöntem kitle dışa aktarımındaki kullanıcıları almak için kullanılır.

Kitle dışa aktarma işlemlerine örneklerle birlikte giriş yapmak için Kitle Dışa Aktarma İşlemi 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ızı sağlar. Daha fazla bilgi için https://support.google.com/analytics/answer/9267572 adresini ziyaret edin.

Audience Export API'lerinin bazı yöntemleri alfa, bazı yöntemleri ise beta kararlılık düzeyindedir. Amaç, geri bildirimler ve benimseme sonrasında yöntemleri beta kararlılığına yükseltmektir. 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/v1beta/{name=properties/*/audienceExports/*}:query

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 dışa aktarma işleminin adı. Biçim: properties/{property}/audienceExports/{audienceExport}

İstek metni

İstek içeriği 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.

Sayfalama sırasında ilk istekte ofset belirtilmez veya ofset 0 olarak ayarlanır. İlk istek, satırların ilk limit'sini döndürür. İkinci istek, ilk isteğin limit değerini ofset olarak ayarlar. İkinci istek, satırların ikinci limit değerini döndürür.

Bu sayfalama parametresi hakkında daha fazla bilgi edinmek için Sayfalama başlıklı makaleyi inceleyin.
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ç satır isterseniz isteyin istek başına en fazla 250.000 satır döndürür. limit pozitif olmalıdır.

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

Bu sayfalama parametresi hakkında daha fazla bilgi edinmek için Sayfalama başlıklı makaleyi inceleyin.

Yanıt metni

Kitle dışa aktarma işlemindeki kullanıcıların listesi.

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

JSON gösterimi 
{
  "audienceRows": [
    {
      object (AudienceRow)
    }
  ],
  "audienceExport": {
    object (AudienceExport)
  },
  "rowCount": integer
}
Alanlar
audienceRows[]

object (AudienceRow)

Kitle dışa aktarma işleminde her kullanıcı için satırlar. Bu yanıttaki satır sayısı, isteğin sayfa boyutundan küçük veya bu değere eşit olacaktır.
audienceExport

object (AudienceExport)

Sorgulanan AudienceExport hakkında yapılandırma verileri. Bu yanıttaki kitle satırlarını yorumlamaya yardımcı olmak için döndürüldü. Örneğin, bu AudienceExport'taki boyutlar, AudienceRows'taki sütunlara karşılık gelir.
rowCount

integer

AudienceExport 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 limit içeriyorsa yanıtta 175 rowCount bulunur ancak yalnızca 50 satır yer alır.

Bu sayfalama parametresi hakkında daha fazla bilgi edinmek için Sayfalama başlıklı makaleyi inceleyin.

Yetkilendirme kapsamları

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

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

AudienceRow

Kitle kullanıcı satırı için boyut değeri özellikleri.

JSON gösterimi 
{
  "dimensionValues": [
    {
      object (AudienceDimensionValue)
    }
  ]
}
Alanlar
dimensionValues[]

object (AudienceDimensionValue)

Bir kitle kullanıcısının her boyut değeri özelliği. İstenen her boyut sütunu için bir boyut değeri eklenir.

AudienceDimensionValue

Bir boyutun değeri.

JSON gösterimi 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "value": string
  // End of mutually exclusive fields.
}
Alanlar
Bir tür boyut değeri. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt içinde en fazla bir alan ayarlanır:
value

string

Boyut türü dizeyse değer dize olarak.
Karşılıklı olarak hariç tutulan alanların sonu.