- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- AudienceRow
- AudienceDimensionValue
- Deneyin.
Kullanıcıların kitleden dışa aktarılmasını sağlar. 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
isteği gereklidir. Daha sonra bu yöntem, kitle dışa aktarma işleminden kullanıcıları geri almak için kullanılır.
Örnekler içeren 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 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.
Kitle Dışa Aktarma API'lerinin alfa sürümünde bazı yöntemleri ve beta kararlılığında başka yöntemleri vardır. Amaç, biraz geri bildirim ve benimseme sürecinden sonra beta kararlılığına yönelik yöntemleri geliştirmektir. 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/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
İsteğin gövdesi, aşağıdaki yapıya sahip veriler 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ı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 Bu sayfalara ayırma parametresi hakkında daha fazla bilgi için Sayfaları numaralandırma konusuna bakın. |
limit |
İ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. Ayrıca, Bu sayfalara ayırma parametresi hakkında daha fazla bilgi için Sayfaları numaralandırma konusuna 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şleminde her kullanıcı için satırlar. Bu yanıttaki satır sayısı, isteğin sayfa boyutundan küçük veya ona eşit olur. |
audienceExport |
Sorgulanan AudienceExport ile ilgili yapılandırma verileri. Bu yanıttaki kitle satırlarının yorumlanmasına 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 Sayfaları numaralandırma konusuna 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ı için boyut değeri özellikleri.
JSON gösterimi |
---|
{
"dimensionValues": [
{
object ( |
Alanlar | |
---|---|
dimensionValues[] |
Kitle kullanıcısına ait her boyut değer ö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ü dizeyse dize olarak değer. |