Mengekspor daftar audiens pengguna ke Spreadsheet Google. Setelah audiens dibuat, pengguna tidak langsung tersedia untuk listingan. Pertama, permintaan ke audienceLists.create
diperlukan untuk membuat daftar audiens pengguna, lalu kedua, metode ini digunakan untuk mengekspor pengguna tersebut dalam daftar audiens ke Spreadsheet Google.
Lihat Membuat Daftar Audiens untuk pengantar Daftar Audiens yang disertai contohnya.
Audiens di Google Analytics 4 memungkinkan Anda menyegmentasikan pengguna dengan cara yang penting bagi bisnis Anda. Untuk mempelajari lebih lanjut, lihat https://support.google.com/analytics/answer/9267572.
Metode ini diperkenalkan di versi alfa yang sudah stabil dengan tujuan mengumpulkan masukan terkait sintaksis dan kemampuan sebelum memasuki versi beta. Untuk memberikan masukan tentang API ini, lengkapi formulir Masukan Google Analytics Audience Export API.
Permintaan HTTP
POST https://analyticsdata.googleapis.com/v1alpha/{name=properties/*/audienceLists/*}:exportSheet
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
name |
Wajib. Nama daftar audiens untuk mengambil pengguna. Format: |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "offset": string, "limit": string } |
Kolom | |
---|---|
offset |
Opsional. Jumlah baris untuk baris awal. Baris pertama dihitung sebagai baris 0. Saat melakukan paging, permintaan pertama tidak menentukan offset; atau yang setara, menyetel offset ke 0; permintaan pertama menampilkan Untuk mempelajari parameter penomoran halaman ini lebih lanjut, lihat Penomoran halaman. |
limit |
Opsional. Jumlah baris yang akan ditampilkan. Jika tidak ditentukan, 10.000 baris akan ditampilkan. API menampilkan maksimum 250.000 baris per permintaan, berapa pun jumlah yang Anda minta. API juga dapat menampilkan baris lebih sedikit daripada Untuk mempelajari parameter penomoran halaman ini lebih lanjut, lihat Penomoran halaman. |
Isi respons
Google Spreadsheet yang berisi daftar pengguna dalam daftar audiens.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"spreadsheetUri": string,
"spreadsheetId": string,
"rowCount": integer,
"audienceList": {
object ( |
Kolom | |
---|---|
spreadsheetUri |
URI yang dapat Anda kunjungi di browser untuk melihat Spreadsheet Google. |
spreadsheetId |
ID yang mengidentifikasi resource Spreadsheet Google yang dibuat. |
rowCount |
Jumlah total baris dalam hasil AudienceList. Untuk mempelajari parameter penomoran halaman ini lebih lanjut, lihat Penomoran halaman. |
audienceList |
Data konfigurasi tentang AudienceList yang diekspor. Ditampilkan untuk membantu menafsirkan AudienceList di Spreadsheet Google respons ini. Misalnya, AudienceList mungkin memiliki lebih banyak baris daripada yang ada di Google Spreadsheet. Dalam hal ini, Anda mungkin ingin mengirim permintaan ekspor sheet tambahan dengan nilai |
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
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