shortcuts_run

macOS

目的

ユーザーの macOS ショートカットの 1 つを名前または識別子で実行します。Mac ユーザーがすでに HomeKit、集中モード、カタログがカバーしていないサードパーティ製アプリの操作を自動化している方法です。サンドボックス化された一部ではなく、ショートカット自身のアクションを、そのショートカット自身の権限で実行します。ショートカットアプリで「実行」をクリックするのと同じです。これは書き込み操作です。最初の呼び出し（confirm=false）はショートカットの名前、識別子、フォルダを示すプレビューを返し、何も実行しません。実際に実行するには confirm=true を設定します。名前が複数のショートカットに一致した場合は、両方の識別子とともに拒否されます。そのうちの 1 つを指定して再度呼び出してください。推測はしないでください。ダイアログを待つショートカットや長時間実行されるショートカットは、一定のタイムアウト後に明確なメッセージとともに停止され、この呼び出しがハングすることはありません。

必須入力

• name_or_identifier

入力名はツールが要求する正確な形式のままです。英語の正規技術定義は下の展開可能なスキーマにあります。

権限と確認

スキーマには明示的な確認パラメータがあります。プレビューを確認し、プラットフォーム契約に従って実操作を承認してください。

• このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の OAuth スコープや OS 権限があるとは主張しません。

{
  "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"
}

ドキュメント例

shortcuts_run のドキュメント例です。この例は実行しないでください。表示される引数は架空のデータセットに属します。実際に呼び出す前に実在する識別子を確認し、承認を得てください。

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