Coba server MCP untuk Google Analytics. Instal dari
GitHub, dan lihat
pengumuman untuk mengetahui detail selengkapnya.
Method: properties.audiences.list
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Mencantumkan Audiens di properti. Audiens yang dibuat sebelum tahun 2020 mungkin tidak didukung. Audiens default tidak akan menampilkan definisi filter.
Permintaan HTTP
GET https://analyticsadmin.googleapis.com/v1alpha/{parent=properties/*}/audiences
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
| Parameter |
parent |
string
Wajib. Contoh format: properties/1234
|
Parameter kueri
| Parameter |
pageSize |
integer
Jumlah maksimum resource yang akan ditampilkan. Jika tidak ditentukan, maksimal 50 resource akan ditampilkan. Nilai maksimum adalah 200 (nilai yang lebih tinggi akan dikonversi menjadi nilai maksimum).
|
pageToken |
string
Token halaman, diterima dari panggilan audiences.list sebelumnya. Berikan atribut ini untuk mengambil halaman selanjutnya. Saat memberi nomor halaman, semua parameter lain yang diberikan ke audiences.list harus cocok dengan panggilan yang menyediakan token halaman.
|
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Pesan respons untuk RPC audiences.list.
Jika berhasil, isi respons memuat data dengan struktur berikut:
| Representasi JSON |
{
"audiences": [
{
object (Audience)
}
],
"nextPageToken": string
} |
| Kolom |
audiences[] |
object (Audience)
Daftar Audiens.
|
nextPageToken |
string
Token, yang dapat dikirim sebagai pageToken untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak ada halaman berikutnya.
|
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/analytics.readonlyhttps://www.googleapis.com/auth/analytics.edit
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-26 UTC.
[null,null,["Terakhir diperbarui pada 2025-07-26 UTC."],[[["\u003cp\u003eLists all audiences on a Google Analytics 4 property, though audiences created before 2020 may have limited support.\u003c/p\u003e\n"],["\u003cp\u003eAllows for pagination to retrieve large lists of audiences using \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e parameters.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes an array of \u003ccode\u003eAudience\u003c/code\u003e objects and a token for retrieving subsequent pages, if available.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with either \u003ccode\u003eanalytics.readonly\u003c/code\u003e or \u003ccode\u003eanalytics.edit\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eDefault audiences may not display their filter definitions.\u003c/p\u003e\n"]]],["This API lists Audiences associated with a property using a `GET` request to a specified URL with a required `parent` path parameter. Optional `pageSize` and `pageToken` query parameters handle pagination. The request body must be empty. The response body contains a list of `audiences` and a `nextPageToken` for pagination. It requires specific authorization scopes (`analytics.readonly` or `analytics.edit`). Audiences created before 2020 might not be fully supported.\n"],null,["# Method: properties.audiences.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListAudiencesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists Audiences on a property. Audiences created before 2020 may not be supported. Default audiences will not show filter definitions.\n\n### HTTP request\n\n`GET https://analyticsadmin.googleapis.com/v1alpha/{parent=properties/*}/audiences`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|----------------------------------------------------|\n| `parent` | `string` Required. Example format: properties/1234 |\n\n### Query parameters\n\n| Parameters ||\n|-------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of resources to return. If unspecified, at most 50 resources will be returned. The maximum value is 200 (higher values will be coerced to the maximum). |\n| `pageToken` | `string` A page token, received from a previous `audiences.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `audiences.list` must match the call that provided the page token. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for audiences.list RPC.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"audiences\": [ { object (/analytics/devguides/config/admin/v1/rest/v1alpha/properties.audiences#Audience) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------|\n| `audiences[]` | `object (`[Audience](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.audiences#Audience)`)` List of Audiences. |\n| `nextPageToken` | `string` A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/analytics.readonly`\n- `https://www.googleapis.com/auth/analytics.edit`"]]
