「ショートカット」でx-callback-urlを使用する

「ショートカット」では、特定の操作が終了しときに呼び出し元Appで応答(コールバック)を受け取るためのx-callback-urlがサポートされます。「URLスキームを使用してショートカットを実行する」で説明したものと同じパラメータを使用して、x-callback-urlからショートカットを実行できます。例を示します:

shortcuts://x-callback-url/run-shortcut?name=Calculate%20Tip&input=text&text=24.99&x-success=...&x-cancel=...

x-callback-url標準によると、次の追加パラメータを指定できます:

  • x-success(任意):操作が成功したとき(たとえば、ショートカットが読み込まれた後や実行が完了した後)に開くURL。ショートカットが実行されると、URLにresultという名前のパラメータが付加されます。このパラメータには、ショートカットのテキスト出力が含まれます。

  • x-cancel(任意):操作がユーザによってキャンセルされたときに開くURL。

  • x-error(任意):エラーが発生して操作が失敗したときに開くURL。URLにerrorMessageという名前のパラメータが付加されます。このパラメータには、エラーの説明が含まれます。

x-successを使用すると、ショートカットの実行が正常に完了した後に開くURLを指定できます。これは「OmniFocus」で複数の手順からなる作業チェックリストと組み合わせて使用できます。x-callback-urlを開いてショートカットを実行し、リストに戻り、次のタスクに移動する、という流れをURLを使って実行できます。

x-cancelを使用すると、ショートカットが実行を完了する前に停止した場合に開く不測事態用のURLを用意できます。ショートカットは完了しなかったため、ショートカットからの出力はありません。

x-errorを使用すると、ショートカットの実行中にエラーが発生して完了できなかった場合に開く不測事態用のURLを用意できます。この場合は、別のURLを起動して問題に対処できます。

国または地域によっては、一部のApp、サービス、およびコンテンツを利用できない場合があります。
Morty Proxy This is a proxified and sanitized view of the page, visit original site.
役に立ちましたか?
入力可能な文字数: 250
入力可能な文字数は 250 です。
フィードバックありがとうございます。
Morty Proxy This is a proxified and sanitized view of the page, visit original site.