iPhoneショートカットでGAS・GitHub Actionsを実行する方法と、専用アプリとの違い
この記事は、比較対象の1つ「Pocket Actions」の開発者が書いています。仕様は確認日時点のAppleとGitHubの公式ドキュメント(リンク先)にもとづいています。確かめられなかったことは「未確認」と書いています。
ショートカットで十分か、アプリを入れるべきか
GASやGitHub Actionsで作った自動化を、iPhoneからボタン1つで動かしたい。そう考えたとき、最初に候補になるのはiPhoneに最初から入っている「ショートカット」アプリです。追加のアプリもお金もいらず、ホーム画面やSiriから実行できます。
一方で、ショートカットでAPIを呼ぶには、URL・ヘッダー・トークン・送るデータを自分で組み立てる必要があります。1本だけなら気になりませんが、ワークフローが増えたり、入力値を毎回変えたくなったりすると、作るのも直すのも手間になります。
この記事では、ショートカットで組む方法の要点を示したうえで、専用アプリを使う場合と何が違うのかを比べます。結論を先に書くと、動かしたいものが1〜2本で、APIを組むのが苦にならないならショートカットで十分です。本数が多い、入力が多い、トークンの扱いを自分で考えたくない、という場合は専用アプリが楽になります。
ショートカットでできること(公式の仕様)
Appleのショートカットユーザガイドによると、ショートカットは次のような方法で実行できます(ショートカットユーザガイド)。
- ショートカットアプリから
- Siri、コントロールセンター、アクションボタン、背面タップ
- ホーム画面のウィジェット、ホーム画面に追加したアイコン、検索画面
また、Web APIを呼び出すためのアクション(「URLの内容を取得」など)があり、JSONの解析もできます。つまり「HTTPリクエストを送るボタン」は、ショートカットで作れます。
GitHub Actionsをショートカットから動かす
GitHub Actionsのワークフローを外から動かす公式の方法は、REST APIの「workflow dispatch イベントの作成」です(GitHub REST API: workflows)。
- エンドポイント:
POST /repos/{owner}/{repo}/actions/workflows/{workflow_id}/dispatches - 送るもの:
ref(ブランチかタグ。必須)とinputs(ワークフローで定義した入力。最大25個) - 前提:ワークフローに
on: workflow_dispatchが書かれていて、そのファイルがデフォルトブランチにあること(Events that trigger workflows) - 認証:classic PATなら
repoスコープ。Fine-grained PATなら「Actions」の書き込み権限(Fine-grained PATに必要な権限)
ショートカットで組むなら、だいたい次の流れです。
- 「URLの内容を取得」アクションを置き、上のURLを入れる
- 方法をPOSTにし、ヘッダーに
Authorization: Bearer <トークン>とAccept: application/vnd.github+jsonを入れる - 本文をJSONにして、
refとinputsを入れる - 入力値を毎回変えたいなら、その前に「入力を要求」アクションを置き、変数として渡す
ここで気をつけたいのはトークンの置き場所です。この作り方では、トークンはショートカットの中に書くことになります。ショートカットを人に共有するときや、iCloudで同期するときに、トークンが一緒に動かないか注意してください(共有・同期時の扱いの詳細は、この記事では確認していません)。
GASをショートカットから動かす
GASを外から動かすよくある方法は、スクリプトを「ウェブアプリ」としてデプロイし、doGet や doPost の関数をURLで呼ぶ方法です。ショートカットからは「URLの内容を取得」でそのURLを開くだけなので、GitHub Actionsより簡単です。
ただし、ウェブアプリを「誰でもアクセス可」にすると、URLを知っている人は誰でも実行できます。URLの扱いはパスワードと同じように考えましょう。また、GASには実行時間(1回6分まで)などの上限があります(Apps Script の割り当てと制限)。
専用アプリを使う場合
iPhoneから workflow_dispatch を実行できるアプリはいくつかあります(詳しくはGitHub Actions向けiPhoneアプリ比較)。ここでは代表として2つを取り上げます。
- GitHub公式アプリ:2024年7月から、ワークフローの画面で
workflow_dispatchを手動実行できます(GitHub Changelog)。GitHubにサインインするだけで、トークンの用意はいりません。ログも見られます。GASは対象外です。 - Pocket Actions:GitHub ActionsとGASのウェブアプリを、1〜3タップで実行するアプリです。ワークフローの
inputsから入力フォームを自動で作ります。トークン(PAT)は端末内の安全な領域にだけ保存します。
比較表
表は横にスクロールできます
| 項目 | iOSショートカット | GitHub公式アプリ | Pocket Actions |
|---|---|---|---|
| 費用 | iPhone標準(無料) | 無料 | 1日5回・週17回まで無料。プレミアム 月額¥380/買い切り¥5,980 |
| GitHub Actionsの実行 | APIを自分で組めばできる | できる(入力も) | できる(入力フォームを自動作成) |
| GASの実行 | ウェブアプリのURLを呼べばできる | できない | できる |
| 実行までのタップ数 | ホーム画面・Siri・背面タップなどから1タップにできる | リポジトリ→Actions→ワークフロー→Run workflowとたどる | 1〜3タップ |
| ブランチの指定 | 自分で ref を書く(自由) | 選べる | main固定(選べない) |
| 入力値 | 「入力を要求」で自作 | 画面で入力 | 自動でフォームを作る |
| トークンの置き場所 | ショートカットの中 | 不要(GitHubにサインイン) | 端末内の安全な領域だけ |
| 結果・ログの確認 | 自分でAPIを追加で呼べば一部可能 | 見られる | 見られない(受け付けの確認のみ) |
| GASのエラー検知 | 返り値を自分で判定すれば可能 | — | スクリプトがエラーでも「成功」と表示される |
| Android | — | あり | なし(クローズドテスト中) |
それぞれの長所と短所
iOSショートカット
- 長所:無料、追加アプリ不要。起動方法が多く、アクションボタンや背面タップに割り当てれば本当に1タップ。リクエストの中身を自由に組めるので、ブランチ指定や結果の取得まで自分で作り込める。
- 短所:APIの仕様を読んで組む必要がある。ワークフローが増えるたびにショートカットを作る。入力フォームも手作業。トークンをショートカットの中に書くことになる。
- 向いている人:動かしたいものが少なく、APIを読むのが苦にならない人。
GitHub公式アプリ
- 長所:無料。サインインだけで使え、トークン管理がいらない。ログや失敗通知もある。
- 短所:ワークフローを動かすまでに画面をいくつかたどる。GASは扱えない。
- 向いている人:GitHubのことはまず公式アプリで済ませたい人。
Pocket Actions
- 長所:GitHub ActionsとGASを1つのアプリにまとめて、1〜3タップで動かせる。入力フォームを自動で作る。サーバーもアプリのアカウント登録もいらない。
- 短所:
- 実行は
mainブランチ固定です。 - GASは、呼び出しが受け付けられれば、スクリプト内でエラーが起きても「成功」と表示されます。結果はGAS側で確認が必要です。
- 実行結果やログはアプリ内で見られません。
- iOSのみで、Android版はクローズドテスト中です。
- 無料は1日5回・週17回までです。
- 自動化そのものは自分で書く必要があります(ノーコードではありません)。
- 実行は
- 向いている人:GitHub ActionsとGASの両方、または本数の多い自動化を、手早く動かしたい人。
ショートカットを最後まで組んでみる
GitHub Actions用(入力付き)
- 「メニューから選択」で
quickとfullを用意し、それぞれに同じ文字の「テキスト」を置く - 「入力を要求」で、メモ欄(テキスト)を用意する
- 「辞書」で、
modeにメニューの結果、noteに入力された値を入れる(数値や真偽値ではなく、テキストとして入れる) - 「URLの内容を取得」で、方法をPOSTにし、ヘッダーに
Accept: application/vnd.github+jsonとAuthorization: Bearer トークンを入れる。本文はJSONにして、refにmain、inputsに3の辞書を入れる - 「辞書の値を取得」で
html_urlを取り出し、値があれば「URLを開く」で実行ページを開き、なければ「結果を表示」で応答を見る
GitHubの現在のREST APIドキュメントでは、workflow dispatchが成功すると200が返り、本文にworkflow_run_id・run_url・html_urlが入ります(REST API)。古いAPIバージョンで本文のない204が返るかどうかは未確認なので、2xxなら成功と考えてください。失敗するとmessageにエラーの内容が入ります。
GAS用(合言葉付き)
function doGet(e) {
const key = PropertiesService.getScriptProperties().getProperty('SHARED_KEY');
if (e.parameter.key !== key) {
return ContentService.createTextOutput('{"ok":false}')
.setMimeType(ContentService.MimeType.JSON);
}
// 実際の処理
return ContentService.createTextOutput('{"ok":true}')
.setMimeType(ContentService.MimeType.JSON);
}
アクセスできるユーザーを「全員」にすると、URLを知っている人は誰でも実行できます。そのため、合言葉を確認して、URLだけでは動かないようにしておきます。ショートカットは、応答のJSONからokを読んで、成否を通知できます。
よくあるエラー
表は横にスクロールできます
| 表示 | 原因 | 対処 |
|---|---|---|
| Not Found | トークンの権限不足、または名前の打ち間違い | リポジトリ名、ファイル名、トークンの対象を確認する |
| Unexpected inputs provided | YAMLにない入力名を送っている | 辞書のキーをYAMLに合わせる |
| GASからHTMLが返る | ログインが必要な設定、またはエラー画面 | Safariで開いて内容を確認する |
| GASの修正が反映されない | /execはデプロイ済みの版を動かす | デプロイを管理 → 編集 → 新しいバージョン(デプロイ) |
エラーメッセージの文言は公式に記載がないため、表の文言は目安です(未確認)。
入力の追加やトークンの入れ替えのたびに、ショートカットも直す必要があります。
タイプ別のおすすめ
- 1〜2本だけ、APIを組める:ショートカット。アクションボタンや背面タップに割り当てると快適です。
- GitHub Actionsだけ、ログも見たい:GitHub公式アプリ。
- GASとGitHub Actionsの両方、または入力つきのワークフローが多い:Pocket Actions。
- 組み合わせる:Pocket Actionsで動かし、結果は公式アプリやGASの実行ログで確認する、という使い分けもできます。
使い方の一例(開発者の場合)
開発者自身は、気になった銘柄をAIに評価させる自動化を、必要なときにPocket Actionsから実行しています。毎日決まった時間に動かす必要のない処理なので、手動実行のボタンとして使っています。
まずは無料で試す
ショートカットを組む前に、どのくらい手間が減るか試してみてください。1日5回まで無料です。
よくある質問
ショートカットだけでGitHub Actionsは動かせますか?
動かせます。workflow dispatchのREST APIに、トークンとref・inputsを付けてPOSTするショートカットを作れば実行できます。
ショートカットに書くトークンは何を選べばいいですか? GitHubはFine-grained PATを推奨しています。workflow dispatchには「Actions」の書き込み権限が必要です。対象のリポジトリと有効期限を絞りましょう。
GASのウェブアプリはショートカットから呼べますか? 呼べます。ウェブアプリのURLを「URLの内容を取得」で開きます。誰でもアクセスできる設定にした場合、URLの扱いに注意してください。
Pocket Actionsはブランチを選べますか?
選べません。GitHub Actionsはmainブランチで実行されます。
Pocket ActionsでGASがエラーになったら分かりますか? 分かりません。呼び出しが受け付けられれば「成功」と表示されます。GASの実行ログで確認してください。
関連記事
- GitHub Actionsをスマホから手動実行する方法の比較
- GASをスマホから実行する方法の比較
- GitHub Actions向けiPhoneアプリ比較
- スマホから自動化を1タップで動かすには?
- Pocket Actionsの更新履歴
最終確認日:2026-11-01(Apple ショートカットユーザガイド、GitHub Docs、GitHub Changelog、Apps Script Docs)。仕様は変わることがあるので、利用前に公式ドキュメントを確認してください。
