Method: properties.audienceExports.query

Mengambil ekspor audiens pengguna. Setelah audiens dibuat, pengguna tidak akan langsung dapat diekspor. Pertama, permintaan ke audienceExports.create diperlukan untuk membuat ekspor audiens pengguna, lalu kedua, metode ini digunakan untuk mengambil pengguna di ekspor audiens.

Lihat Membuat Ekspor Audiens untuk mengetahui pengantar Ekspor Audiens dengan contoh.

Audiens di Google Analytics 4 memungkinkan Anda menyegmentasikan pengguna dengan cara yang relevan bagi bisnis Anda. Untuk mempelajari lebih lanjut, lihat https://support.google.com/analytics/answer/9267572.

Audience Export API memiliki beberapa metode di versi alfa dan metode lainnya dengan stabilitas beta. Tujuannya adalah untuk meningkatkan metode ke stabilitas beta setelah beberapa masukan dan adopsi. Untuk memberikan masukan tentang API ini, lengkapi formulir Masukan tentang Ekspor Audiens Google Analytics.

Permintaan HTTP

POST https://analyticsdata.googleapis.com/v1beta/{name=properties/*/audienceExports/*}:query

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

Wajib diisi. Nama audiens yang diekspor sebagai asal ekspor pengguna. Format: properties/{property}/audienceExports/{audienceExport}

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "offset": string,
  "limit": string
}
Kolom
offset

string (int64 format)

Opsional. Jumlah baris pada baris awal. Baris pertama dihitung sebagai baris 0.

Saat melakukan paging, permintaan pertama tidak menentukan offset; atau yang setara, mengatur offset ke 0; permintaan pertama menampilkan limit baris pertama. Set permintaan kedua di-offset ke limit permintaan pertama; permintaan kedua akan menampilkan limit baris kedua.

Untuk mempelajari lebih lanjut parameter penomoran halaman ini, lihat Penomoran halaman.
limit

string (int64 format)

Opsional. Jumlah baris yang akan ditampilkan. Jika tidak ditentukan, total 10.000 baris akan ditampilkan. API ini menampilkan maksimum 250.000 baris per permintaan, berapa pun jumlah yang Anda minta. limit harus positif.

API juga dapat menampilkan lebih sedikit baris daripada limit yang diminta, jika nilai dimensi tidak sebanyak limit.

Untuk mempelajari lebih lanjut parameter penomoran halaman ini, lihat Penomoran halaman.

Isi respons

Daftar pengguna dalam ekspor audiens.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "audienceRows": [
    {
      object (AudienceRow)
    }
  ],
  "audienceExport": {
    object (AudienceExport)
  },
  "rowCount": integer
}
Kolom
audienceRows[]

object (AudienceRow)

Baris untuk setiap pengguna dalam ekspor audiens. Jumlah baris dalam respons ini akan kurang dari atau sama dengan ukuran halaman permintaan.
audienceExport

object (AudienceExport)

Data konfigurasi tentang AudienceExport yang dikueri. Ditampilkan untuk membantu menafsirkan baris audiens dalam respons ini. Misalnya, dimensi dalam AudienceExport ini sesuai dengan kolom di AudienceRows.
rowCount

integer

Jumlah total baris dalam hasil AudienceExport. rowCount tidak bergantung pada jumlah baris yang ditampilkan dalam respons, parameter permintaan limit, dan parameter permintaan offset. Misalnya, jika kueri menampilkan 175 baris dan menyertakan limit dari 50 dalam permintaan API, responsnya akan berisi rowCount dari 175 baris, tetapi hanya 50 baris.

Untuk mempelajari lebih lanjut parameter penomoran halaman ini, lihat Penomoran halaman.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

AudienceRow

Atribut nilai dimensi untuk baris pengguna audiens.

Representasi JSON 
{
  "dimensionValues": [
    {
      object (AudienceDimensionValue)
    }
  ]
}
Kolom
dimensionValues[]

object (AudienceDimensionValue)

Setiap atribut nilai dimensi untuk pengguna audiens. Satu nilai dimensi akan ditambahkan untuk setiap kolom dimensi yang diminta.

AudienceDimensionValue

Nilai dimensi.

Representasi JSON 
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
Kolom
Kolom union one_value. Satu jenis nilai dimensi. one_value hanya dapat berupa salah satu dari berikut:
value

string

Nilai sebagai string jika jenis dimensinya adalah string.