Coba server MCP untuk Google Analytics. Instal dari
GitHub, dan lihat
pengumuman untuk mengetahui detail selengkapnya.
Method: properties.reportingDataAnnotations.list
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Mencantumkan semua Anotasi Data Pelaporan di properti.
Permintaan HTTP
GET https://analyticsadmin.googleapis.com/v1alpha/{parent=properties/*}/reportingDataAnnotations
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
| Parameter |
parent |
string
Wajib. Nama resource properti. Format: properties/property_id Contoh: properties/123
|
Parameter kueri
| Parameter |
filter |
string
Opsional. Filter yang membatasi anotasi data pelaporan yang tercantum di properti induk. Kolom yang didukung adalah:
- 'name'
titledescriptionannotationDateannotationDateRangecolor Selain itu, API ini menyediakan fungsi bantuan berikut:
- annotation_duration() : durasi yang ditandai anotasi ini, durations. mengharapkan representasi numerik detik yang diikuti dengan akhiran
s.
- is_annotation_in_range(startDate, endDate) : jika anotasi berada dalam rentang yang ditentukan oleh
startDate dan endDate. Tanggal dalam format ISO-8601, misalnya 2031-06-28.
Operasi yang didukung:
= : sama dengan!= : tidak sama dengan< : kurang dari> : lebih besar dari<= : kurang dari atau sama dengan>= : lebih besar dari atau sama dengan: : operator has=~ : Kecocokan ekspresi reguler!~ : ekspresi reguler tidak cocokNOT : Logika bukanAND : Logika danOR : Logika atau Contoh:
title="Holiday Sale"description=~"[Bb]ig [Gg]ame.*[Ss]ale"is_annotation_in_range("2025-12-25", "2026-01-16") = trueannotation_duration() >= 172800s AND title:BOGO
|
pageSize |
integer
Opsional. Jumlah maksimum resource yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini, meskipun ada halaman tambahan. Jika tidak ditentukan, paling banyak 50 resource akan ditampilkan. Nilai maksimumnya adalah 200; (nilai yang lebih tinggi akan dikonversi menjadi maksimum)
|
pageToken |
string
Opsional. Token halaman, diterima dari panggilan reportingDataAnnotations.list sebelumnya. Berikan ini untuk mengambil halaman berikutnya. Saat melakukan penomoran halaman, semua parameter lain yang diberikan untuk reportingDataAnnotations.list harus sesuai dengan panggilan yang menyediakan token halaman.
|
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Pesan respons untuk RPC ListReportingDataAnnotation.
Jika berhasil, isi respons memuat data dengan struktur berikut:
| Representasi JSON |
{
"reportingDataAnnotations": [
{
object (ReportingDataAnnotation)
}
],
"nextPageToken": string
} |
| Kolom |
reportingDataAnnotations[] |
object (ReportingDataAnnotation)
Daftar Anotasi Data Pelaporan.
|
nextPageToken |
string
Token yang dapat dikirim sebagai pageToken untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan 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."],[],[],null,["# Method: properties.reportingDataAnnotations.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.ListReportingDataAnnotationsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nList all Reporting Data Annotations on a property.\n\n### HTTP request\n\n`GET https://analyticsadmin.googleapis.com/v1alpha/{parent=properties/*}/reportingDataAnnotations`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|----------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. Resource name of the property. Format: properties/property_id Example: properties/123 |\n\n### Query parameters\n\n| Parameters ||\n|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `filter` | `string` Optional. Filter that restricts which reporting data annotations under the parent property are listed. Supported fields are: - 'name' - `title` - `description` - `annotationDate` - `annotationDateRange` - `color` Additionally, this API provides the following helper functions: - annotation_duration() : the duration that this annotation marks, [durations](https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/duration.proto). expect a numeric representation of seconds followed by an `s` suffix. - is_annotation_in_range(startDate, endDate) : if the annotation is in the range specified by the `startDate` and `endDate`. The dates are in ISO-8601 format, for example `2031-06-28`. Supported operations: - `=` : equals - `!=` : not equals - `\u003c` : less than - `\u003e` : greater than - `\u003c=` : less than or equals - `\u003e=` : greater than or equals - `:` : has operator - `=~` : [regular expression](https://github.com/google/re2/wiki/Syntax) match - `!~` : [regular expression](https://github.com/google/re2/wiki/Syntax) does not match - `NOT` : Logical not - `AND` : Logical and - `OR` : Logical or Examples: 1. `title=\"Holiday Sale\"` 2. `description=~\"[Bb]ig [Gg]ame.*[Ss]ale\"` 3. `is_annotation_in_range(\"2025-12-25\", \"2026-01-16\") = true` 4. `annotation_duration() \u003e= 172800s AND title:BOGO` |\n| `pageSize` | `integer` Optional. The maximum number of resources to return. The service may return fewer than this value, even if there are additional pages. 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` Optional. A page token, received from a previous `reportingDataAnnotations.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `reportingDataAnnotations.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 ListReportingDataAnnotation RPC.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"reportingDataAnnotations\": [ { object (/analytics/devguides/config/admin/v1/rest/v1alpha/properties.reportingDataAnnotations#ReportingDataAnnotation) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `reportingDataAnnotations[]` | `object (`[ReportingDataAnnotation](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.reportingDataAnnotations#ReportingDataAnnotation)`)` List of Reporting Data Annotations. |\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`"]]
