shortcuts_run

macOS

Scopo

Esegue uno dei Comandi rapidi di macOS dell’utente per nome o identificatore: il modo in cui gli utenti Mac automatizzano già HomeKit, le modalità di concentrazione e azioni di app di terze parti che il catalogo non copre. Esegue le azioni PROPRIE del comando rapido con le autorizzazioni del comando rapido stesso, non un sottoinsieme isolato: come fare clic su Esegui nell’app Comandi rapidi. È un’operazione di scrittura: la prima chiamata (confirm=false) restituisce un’anteprima con il nome del comando rapido, il suo identificatore e la sua cartella, senza eseguire nulla; imposta confirm=true per eseguirlo davvero. Un nome che corrisponde a più di un comando rapido viene rifiutato con entrambi gli identificatori: richiama con uno di essi, senza mai indovinare. Un comando rapido che attende una finestra di dialogo o dura troppo viene interrotto dopo un timeout limitato con un messaggio chiaro, invece di bloccare questa chiamata.

Input obbligatori

• name_or_identifier

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 dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

• 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": {
    "confirm": {
      "description": "Must be true to actually run the shortcut. Without it, returns a preview.",
      "type": "boolean"
    },
    "input_text": {
      "description": "Optional text input for the shortcut, passed via a temp file — omit if the shortcut takes no input.",
      "type": "string"
    },
    "name_or_identifier": {
      "description": "Shortcut name or identifier, from shortcuts_list. An ambiguous name is refused — pass the identifier instead.",
      "type": "string"
    }
  },
  "required": [
    "name_or_identifier"
  ],
  "type": "object"
}

Esempio documentale

Esempio di documentazione per shortcuts_run. 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.

{
  "confirm": false,
  "name_or_identifier": "Demo morning brief"
}