本文へスキップ
Google スプレッドシートのURLをn8nで一行ずつ短縮する

Google スプレッドシートのURLをn8nで一行ずつ短縮する

配布用の短縮URLを元の行に戻し、失敗した行だけをやり直す手順です。

金曜日の午後、キャンペーンの管理シートに十二本のURLが届きました。担当者は一本ずつ短縮して結果を戻します。その直後に二件の差し替えが来ると、印刷に回したリンクを探すだけでも時間がかかります。毎回同じ作業をするなら、シートの一行と公開用の短縮URL一本をひも付けておくと管理しやすくなります。Google スプレッドシートから対象行を読み、n8nでchck.myのAPIを呼び、短縮URLを元の行へ書き戻す手順を紹介します。

書店のイベントを二つの媒体に載せる

架空の書店が、同じイベント案内をメールマガジンと店頭ポスターに載せます。元の案内ページが同じでも、配布先を区別できるように二行に分けました。下の短縮URLは記入例です。

row_idrevisioninput_urlstatusshort_url
book-fair-email1example.com/book-fair?utm_source=newsletterREADY空欄
book-fair-poster1example.com/book-fair?utm_source=posterDONEchck.my/Ab3xYz9

実際の input_url には、ブラウザーのアドレスバーからコピーしたHTTPSの完全なURLを入れます。自動化が一行目を処理すると、short_url に結果が入り、status が DONE になります。さらに link_id を置くと、担当者は後から同じリンクを探せます。失敗だけを絞り込めるように、error_code の列も用意しておきましょう。最初の試運転には、まだ外に配っていない一行を使います。

行のIDを固定して依頼の版を管理する

row_id は並べ替えても変わらない識別子です。書店の例では book-fair-email をそのまま externalId として送ります。chck.myは同じワークスペース内でその値を持つリンクを探し、見つかれば更新または返却し、無ければ作成します。複数のシートから同じワークスペースに送る場合は、シートや案件を表す短い接頭辞を付けると識別子を管理しやすくなります。

任意のリクエストヘッダー Idempotency-Key で、一回の作成や更新を特定します。一行目の最初の依頼には links.book-fair-email.v1 を使います。タイムアウトしたときは、送信内容とキーをそのまま再利用します。公開済みのリンクの転送先を直す場合は、承認した変更を revision の2番として扱い、同じ externalId で links.book-fair-email.v2 を送ります。これで公開用のアドレスを保ったまま転送先を更新できます。版は、確認済みの入力を更新するときに進めましょう。

n8nで一行を読み書きする

chck.myのProまたはTeamワークスペースと、書き込み可能なAPIキーを用意します。n8nで実行できる環境と、検証用シートの読み取り・編集ができるGoogleの認証情報も必要です。n8nや接続する外部サービスの費用は利用中の契約を確認してください。

  1. Manual Trigger → Google SheetsのGet Row(s)。 まずは row_id で絞って一行だけ読みます。複数行の運用に移る際は状態が READY の行を選び、フィルターに合う行をすべて返す設定にします。ポスターの行がすでに完了していれば、読み取り対象から外れます。
  2. HTTP Request。 メソッドは PUT です。末尾の開発者向け資料にあるAPIのベースURLに /links/upsert を追加して指定します。Generic Credential TypeでHeader Authを選び、ヘッダー名を Authorization、値を Bearer、空白、発行したキーの順に入力します。値はn8nの認証情報に保存します。本文はJSONにし、url に input_url、externalId に row_id を対応させます。行のIDと変更番号で作った Idempotency-Key もヘッダーで渡します。
  3. 応答を判定 → Google SheetsのUpdate Row。 HTTP RequestのInclude Response Headers and StatusとNever Errorを有効にすると、HTTPステータスを分岐に使えます。2xx で本文に shortLink がある場合、読み取り時の row_id で既存行を探し、shortLink を short_url、id を link_id、DONE を status に書きます。失敗した行には状態とエラーコードを記録し、配布済みのURLは残します。

同じ行を二回実行し、同じ id と shortLink が返ることを確かめます。その後シートを並べ替えて、同じIDの行に結果が入ることを確認しましょう。APIが成功したあとにシートへの書き込みだけが止まることもあります。その場合は元のキーと本文で再実行し、返ってきた結果を記録します。

失敗した行を一つずつ戻す

HTTPの 429 が返ったら Retry-After を確認し、指定された間隔を空けて対象行だけを限られた回数で再試行します。ネットワークエラーやタイムアウトはHTTPの応答とは別に、n8nのエラー側の経路で扱います。読み込んだ行のIDと版を控えれば、やり直す依頼を見つけやすくなります。

400 は入力やURLを、401 はキーを、403 は契約やキーの範囲とワークスペースの権限を確認する目安です。409 では同じ依頼キーで入力を書き換えていないか確認します。410 は以前の結果が削除された場合や、結果を返せる30日間が過ぎた場合に返ることがあります。新しい依頼を出す前にリンク一覧と元の変更内容を確認してください。422 の場合は、転送先をURLの安全ルールと照らし合わせます。

n8nの実行履歴には送信内容や応答が残ることがあります。共有シートには公開できる転送先を置き、APIキーは認証情報で管理します。キーが漏れた場合はchck.myで無効にし、新しく発行したキーをn8nに設定します。担当が変わるときは、シートやワークフローの編集権限も一緒に見直しましょう。

まず下の開発者向けガイドを開き、APIキーの準備とリンクの応答例を確認してから、検証用の一行を流してみてください。結果のURLを開けて、二度実行しても同じリンクが戻れば、本番の行を増やす前の確認ができます。

参考資料

短縮URL自動化n8nGoogle スプレッドシート短縮URL API

あわせて読みたい