iOSのショートカットでGoogle Apps ScriptにPOSTリクエストを送信する

はじめに

iOSのショートカット機能を使って指定したGoogle Apps Scriptに任意のデータをPOSTさせたのでその手順をまとめます。

できるようになること

以下のような内容のiOSのショートカットを作成し、

このショートカットをタップすると以下のようにショートカットから送信したデータをGoogleスプレッドシートに書き込めるようになります。

ショートカットから送信するデータは適当な固定値やショートカットを実行した時点での現在地など変数ももちろん指定できます。 この記事で紹介するショートカット自体は実用性がありませんが、ショートカットから任意のデータをGoogle Apps ScriptにPOSTリクエストを送信できると、色々な応用に使用できると思います。

前提と環境

以下の通りです。

• iOS : 12.0 以降

手順概要

以下の２つが必要になります。

• Google Apps ScriptでPOSTデータを受け付けるスクリプトを公開する
• POSTリクエストを送信するショートカットを作成する

Google Apps ScriptでPOSTリクエストを受信できるようにするための手順などはこの記事には記載していません。Googleスプレッドシートなどでスクリプトエディタを開き、適当にスクリプトを記述した後にPOSTリクエストを受信できるよう設定が必要です。この手順については以下にまとめているので必要な方は見てみてください。

Google Apps ScriptでPOSTデータを受け付けるスクリプトを公開する

まずは適当なスプレッドシートを作成し、スクリプトエディタでPOSTデータを受け付けるGoogle Apps Scriptを作成します。スクリプトの内容を以下のようにします。

function doPost(e) {
  var params = JSON.parse(e.postData.getDataAsString()); // POSTされたデータを取得
  var myData = params.mydata.value;  // ショートカットで指定したPOSTデータを取得
  var result = {};
     
  var output = ContentService.createTextOutput();
  output.setMimeType(ContentService.MimeType.JSON);
  // addLog("params is :" + JSON.stringify(params)); // デバッグ用
  
  if (myData){
    
    result = {
      "success" : {
        "message" : "正常に処理されました。"
      }
    };
    addLog( JSON.stringify(myData) ); // スプレッドシートにショートカットから送信されてきたデータを記録
    
  } else {
    result = {
   "error": {
       "message": "データがありません。"
     }
   };
  }
  
  // 返すデータ（上記のresult）をセットする
  output.setContent(JSON.stringify(result));
  
  // リクエスト元（ショートカット）に返す
  return output;
}

function addLog(text) {
  var spreadsheetId = "shoiaj298jowo9rjp32ipkife"; // スプレッドシートID
  var sheetName = "log"; // スプレッドシート名
  var spreadsheet = SpreadsheetApp.openById(spreadsheetId);
  var sheet = spreadsheet.getSheetByName(sheetName);
  sheet.appendRow([new Date(),text]); // スプレッドシートにタイムスタンプと引数を書き込む
}

上記のコードでポイントとなるのは、Google Apps Script内で以下のようにしてショートカットから送られてくるデータを取得しています。

var myData = params.mydata.value;  // ショートカットで指定したPOSTデータを取得

これは、ショートカットからGoogle Apps Scriptに対して送るPOSTデータを以下のようにしているためです。

mydata : {
 value : "ショートカットからのデータ"
}

上記は私が勝手に決めたものです。重要なのは、ショートカットからGoogle Apps ScriptにPOSTするデータと、Google Apps Scriptが受信時の処理でオブジェクトのキー名等は当然ながら合わせる必要があります。 合わせていればネストしているような少々複雑なデータでも問題なくPOSTしてGoogle Apps Scriptで受け取ることができます。例えば、もしショートカットから以下のようなデータをGoogle Apps ScriptにPOSTする場合は、

mydata : {
 value : "ショートカットからのデータ"
 myObject : {
   objValueA : "オブジェクトデータA"
   objValueB : "オブジェクトデータB"
 } 
}

Google Apps Script側では以下のようにしてデータを取得できます。

var myData = params.mydata.value; // "ショートカットのデータ"
var myObjectDataA = params.mydata.myObject.objValueA;  // "オブジェクトデータA"
var myObjectDataB = params.mydata.myObject.objValueB;  // "オブジェクトデータB"

実際に上記のような任意のデータをPOSTリクエストを送信するショートカットの作成手順を次にまとめます。

POSTリクエストを送信するショートカットを作成する

POSTリクエストを送信するショートカットの作成方法自体は、以下のApple公式ドキュメントを参考にしました。

まずは、iOSでショートカットを開き、右上の「＋」ボタンをタップします。すると以下のように「新規ショートカット」と表示されるので画面下部にある「Appおよびアクションを検索」をタップします。

以下のように「url」と入力して検索すると、URLに関連するアクションが表示されるので、この中にある「URL」をタップします。

以下のように「URL」アクションが追加されます。このURLの中に、Google Apps Scriptで公開しているURLを貼り付けます。

続いて、改めて「Appおよびアクションを検索」で「url」と検索して今度は以下のように「URLの内容を取得」をタップします。

以下のように表示されるので、ここで「表示を増やす」をタップします。

後は以下のように、各項目をPOST用に設定します。「方法」を「POST」、「本文を要求」を「JSON」にします。

「新規フィールドの追加」をタップして、実際にこのショートカットからGoolge Apps Scriptに送信したいPOSTデータを作成します。 例えば、ここでは以下のようなデータをPOSTしたい場合を想定します。

mydata : {
 value : "ショートカットからのデータ"
}

上記のようなデータはいわゆるオブジェクトとなるので、「新規フィールドの追加」をタップして以下のように「辞書」を選択します。

そしてキー名をmydataと入力します。

上記で「０項目」となっている部分をタップすると、以下のようにmydataに含めたいデータを追加できます。ここで「新規項目を追加」をタップし、今度は「テキスト」を指定します。

後は以下のようにキー名とその内容（テキスト）を入力します。

これで作業は完了です。最終的にショートカットの内容は以下のようになっていると思います。試しに、右下にある再生ボタンをタップします。

正常に動作すると、以下のようにGoogle Apps ScriptにPOSTした結果が返ってきて表示されます。

また、Google Apps Script側でも確認してみると、以下のようにショートカットからのデータが追加されていると思います。

動作を確認できたら作成したショートカットを保存して完了です。このショートカットを実行するとPOSTリクエストをGoogle Apps Scriptに送信できます。 ただし、これではただの固定データを毎回POSTするだけで実用性がありません。そこで固定データではなく、例えばショートカットを実行した時点での位置情報をPOSTしてみます。

位置情報をPOSTする

最終的に以下のようなショートカットを作成します。

変更点は、「URL」の前に２つのアクションを追加しています。一番上が「現在地を取得」、その次が「変数を設定」です。この２つのアクションはそれぞれ「Appおよびアクションを検索」から検索できます。 これら２つを追加してつなげることで、現在地という変数を設定できます。 そしてこの現在地という変数をすでに説明したPOSTデータの中に含めます。具体的には以下のようになります。

上記には、キー名valueのデータとして変数現在地を指定しています。これによって、このショートカット実行時の現在地をPOSTすることができます。 このように、変数を使うことで動的な値をPOSTすることができるので色々な応用を考えられます。

まとめ

ショートカットはかなり色々なことができ、ちょっとした業務効率化やライフハックなどに使えそうです。