Method: notes.list

Lista as notas.

Cada chamada de lista retorna uma página de resultados com pageSize como o limite superior dos itens retornados. Um pageSize de zero permite que o servidor escolha o limite superior.

O ListNotesResponse contém no máximo pageSize entradas. Se houver mais itens para listar, ele fornecerá um valor nextPageToken. Os tokens de página são valores opacos.

Para ver a próxima página de resultados, copie o nextPageToken do resultado para o pageToken da próxima solicitação. Repita até que o nextPageToken retornado com uma página de resultados esteja vazio.

O notes.list retorna resultados consistentes diante de alterações simultâneas ou sinaliza que não pode com um erro ABORTED.

Solicitação HTTP

GET https://keep.googleapis.com/v1/notes

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de consulta

Parâmetros
pageSize

integer

O número máximo de resultados a serem retornados.

pageToken

string

O campo nextPageToken da página anterior.

filter

string

Filtre os resultados da lista. Se nenhum filtro for fornecido, o filtro trashed será aplicado por padrão. Os campos válidos a serem filtrados são: createTime, updateTime, trashTime e trashed.

A sintaxe do filtro segue as especificações de filtragem de IP do Google.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

A resposta ao listar uma página de notas.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "notes": [
    {
      object (Note)
    }
  ],
  "nextPageToken": string
}
Campos
notes[]

object (Note)

Uma página de notas.

nextPageToken

string

Campo pageToken da próxima página.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

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

Para mais informações, consulte o Guia de autorização.