- HTTP isteği
- Yol parametreleri
- İstek gövdesi
- Yanıt metni
- Yetkilendirme kapsamları
- AudienceRow
- AudienceDimensionValue
- Deneyin.
Kullanıcıların kitle dışa aktarımını alır. Kitle oluşturulduktan sonra kullanıcılar dışa aktarma işlemi için hemen kullanılamaz. Öncelikle, kullanıcıların kitle dışa aktarımını oluşturmak için audienceExports.create
öğesine istek gönderilmesi gerekir. İkinci olarak, kitle dışa aktarımında kullanıcıları almak için bu yöntem kullanılır.
Örneklerle kitle dışa aktarma işlemlerine giriş için Kitle Dışa Aktarma 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.
Kitle Dışa Aktarma API'leri, alfa sürümünde bazı yöntemler ve beta kararlılığında başka yöntemler kullanır. Amaç, bir miktar geri bildirim verildikten ve benimsendikten sonra beta kararlılığına yönelik yöntemler geliştirmektir. 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 |
Zorunlu. Kullanıcıların alınacağı kitle dışa aktarma işleminin adı. Biçim: |
İ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 |
İ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 Bu sayfalara ayırma parametresi hakkında daha fazla bilgi için Sayfalara ayırma bölümüne bakın. |
limit |
İ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. Ayrıca, 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 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 ( |
Alanlar | |
---|---|
audienceRows[] |
Kitle dışa aktarma işlemindeki her kullanıcının satırları. Bu yanıttaki satır sayısı, isteğin sayfa boyutundan az veya bu boyuta eşit olacaktır. |
audienceExport |
Sorgulanmakta olan AudienceExport ile ilgili 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'daki sütunlara karşılık gelir. |
rowCount |
AudienceExport sonucundaki toplam satır sayısı. Bu sayfalara ayırma parametresi hakkında daha fazla bilgi için Sayfalara ayırma bölümüne bakın. |
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ının boyut değeri özellikleri.
JSON gösterimi |
---|
{
"dimensionValues": [
{
object ( |
Alanlar | |
---|---|
dimensionValues[] |
Bir kitle kullanıcısına ait her bir 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 |
---|
{ // Union field |
Alanlar | |
---|---|
Birleştirme alanı one_value . Bir tür boyut değeri. one_value şunlardan yalnızca biri olabilir: |
|
value |
Boyut türü bir dizeyse dize olarak değer. |