search_notes

macOS

Scopo

Cerca in Apple Notes per titolo o contenuto. I risultati sono impaginati: `limit` è limitato a un massimo di 100 per chiamata, quindi scorri le pagine con `offset` invece di richiedere un limite maggiore. La risposta contiene `total` (il numero complessivo di note che corrispondono alla query) e `has_more`, perciò una pagina limitata non viene mai scambiata per la risposta completa: continua finché `has_more` è false, risultato esatto anche quando `total_is_estimated` indica che il conteggio è soltanto un limite inferiore. Per scorrere tutte le corrispondenze, passa order="id": consulta il parametro order.

Input obbligatori

• query

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.

• Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.

{
  "properties": {
    "limit": {
      "default": "20",
      "description": "Matches per page (default 20, capped at 100). To get more, page with offset.",
      "type": "integer"
    },
    "offset": {
      "default": "0",
      "description": "How many matches to skip (default 0). An offset past the end returns an empty page with has_more=false, not an error.",
      "minimum": 0,
      "type": "integer"
    },
    "order": {
      "default": "modified",
      "description": "order: \"modified\" (default) sorts newest-modified first — what you want to SHOW someone, but NOT safe for paging: modification date changes, so a note edited between two calls jumps to the front and another note is pushed past your cursor and never returned. \"id\" sorts by the note's immutable store id — stable, never renumbered, new notes append at the end — so use order=\"id\" to walk an entire library page by page: edits and insertions mid-crawl are safe with it. One case it cannot cover, because pages are addressed by offset: if a note is DELETED mid-crawl, every note after the hole shifts one slot back and the note that was on the page boundary is skipped, silently. If completeness matters, re-run the crawl and reconcile against total, or crawl while nothing is deleting notes.",
      "type": "string"
    },
    "query": {
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Esempio documentale

Esempio di documentazione per search_notes. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

{
  "query": "launch checklist"
}