Method: notes.list
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Elenca le note.
Ogni chiamata all'elenco restituisce una pagina di risultati con pageSize come limite superiore degli elementi restituiti. Un valore pageSize pari a zero consente al server di scegliere il limite superiore.
ListNotesResponse contiene al massimo pageSize voci. Se ci sono altri elementi da elencare, viene fornito un valore nextPageToken. I token di pagina sono valori non trasparenti.
Per ottenere la pagina di risultati successiva, copia nextPageToken del risultato in pageToken della richiesta successiva. Ripeti finché nextPageToken restituito con una pagina di risultati non è vuoto.
notes.list restituisce risultati coerenti in caso di modifiche simultanee oppure indica che non può farlo con un errore ABORTED.
Richiesta HTTP
GET https://keep.googleapis.com/v1/notes
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri di query
| Parametri |
pageSize |
integer
Il numero massimo di risultati da restituire.
|
pageToken |
string
Il campo nextPageToken della pagina precedente.
|
filter |
string
Filtra i risultati dell'elenco. Se non viene fornito alcun filtro, per impostazione predefinita viene applicato il filtro trashed. I campi validi per i filtri sono: createTime, updateTime, trashTime e trashed. La sintassi del filtro segue le specifiche di filtraggio di Google AIP.
|
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
La risposta quando viene elencata una pagina di note.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"notes": [
{
object (Note)
}
],
"nextPageToken": string
} |
| Campi |
notes[] |
object (Note)
Una pagina di appunti.
|
nextPageToken |
string
Campo pageToken della pagina successiva.
|
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/keephttps://www.googleapis.com/auth/keep.readonly
Per ulteriori informazioni, consulta la Guida all'autorizzazione.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[],[],null,["# Method: notes.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListNotesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nLists notes.\n\nEvery list call returns a page of results with `pageSize` as the upper bound of returned items. A `pageSize` of zero allows the server to choose the upper bound.\n\nThe ListNotesResponse contains at most `pageSize` entries. If there are more things left to list, it provides a `nextPageToken` value. (Page tokens are opaque values.)\n\nTo get the next page of results, copy the result's `nextPageToken` into the next request's `pageToken`. Repeat until the `nextPageToken` returned with a page of results is empty.\n\nnotes.list return consistent results in the face of concurrent changes, or signals that it cannot with an ABORTED error.\n\n### HTTP request\n\n`GET https://keep.googleapis.com/v1/notes`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of results to return. |\n| `pageToken` | `string` The previous page's `nextPageToken` field. |\n| `filter` | `string` Filter for list results. If no filter is supplied, the `trashed` filter is applied by default. Valid fields to filter by are: `createTime`, `updateTime`, `trashTime`, and `trashed`. Filter syntax follows the [Google AIP filtering spec](https://aip.dev/160). |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe response when listing a page of notes.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------|\n| ``` { \"notes\": [ { object (/workspace/keep/api/reference/rest/v1/notes#Note) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------|\n| `notes[]` | `object (`[Note](/workspace/keep/api/reference/rest/v1/notes#Note)`)` A page of notes. |\n| `nextPageToken` | `string` Next page's `pageToken` field. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/keep`\n- `https://www.googleapis.com/auth/keep.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
