ショップのメタフィールド・トリガー
ショップのメタフィールドが変更された際に、Shopify Flowのワークフローを開始します。Workflow Trigger Extensionsでその変更を追跡し、変更前の値と変更後の値を取得します。
ストアでは、休業日などのストア全体に関するお知らせを、ストアのメタフィールド「休日のお知らせ」(custom.holiday_notice)に1つ登録し、テーマがそれを表示します。誰かがお知らせを変更すると、チームはすぐに新しい内容を確認できるようになります。
このページでは、Workflow Trigger Extensionsを使用して、ショップのメタフィールドに変更があった際にShopify Flowワークフローを開始する方法について説明します。手順はこのリソースタイプのすべてのメタフィールドで共通です。例では「休業のお知らせ」(custom.holiday_notice)を使用しています。
必要なもの
- メタフィールドの定義です。Shopifyの管理画面で、「設定」>「メタフィールドとメタオブジェクト」>「ショップ」から作成してください。定義のないメタフィールドは追跡できません。
- 追加の権限は必要ありません。アプリをインストールするだけで、ショップのメタフィールドを追跡できるようになります。
1. メタフィールドを追跡する
- アプリで「メタフィールドのトリガー」を開き、「トリガーを追加」をクリックしてください。
- リソースの種類として「ショップ」を選択してください。
- 「Holiday notice」というメタフィールドにチェックを入れてください。複数の項目を一度にチェックすることも、「すべて選択」を使用することもできます。
- 「トリガーを追加」をクリックしてください。
このリソースタイプのすべてのメタフィールド(後で作成するメタフィールドも含む)を追跡するには、個々のメタフィールドにチェックを入れるのではなく、「すべてのメタフィールド」を選択し、次に「すべてのメタフィールドを追跡」をクリックしてください。

このトリガーは「即時有効」です。アプリがショップ情報を初めて読み込んだ際は、ワークフローを開始せずに現在の値を保存します。それ以降の変更があるたびに、ワークフローが開始されます。
リストにメタフィールドが含まれていない場合は、「メタフィールド・トリガー」ページにある「メタフィールドを更新」をクリックしてください。アプリは定義のリストを1時間記憶しています。
2. ワークフローが受け取るもの
変更が行われるたびに、Shopify Flow において「メタフィールド Update」トリガーが、以下の値で起動します:
| 変数 | 値 |
|---|---|
resourceType |
SHOP |
resourceId |
ショップのIDです。例えば、gid://shopify/Shop/1234567890 |
metafieldKey |
名前空間とキー、ここではcustom.holiday_noticeです |
metafield.value |
新たな価値 |
metafield.previousValue |
変更前の値。メタフィールドが初めて設定された場合は空です。 |
metafield.type |
メタフィールドの型です。例えば、single_line_text_field などです。 |
3. ワークフローを構築する
- Shopify Flow でワークフローを作成し、Workflow Trigger Extensionsのトリガー「メタフィールド Update」を選択してください。
- 条件を追加します:
resourceTypeがSHOPと等しいこと。メタフィールドの更新は、追跡対象のリソースタイプごとに開始されるため、この条件を設定することで、このワークフローをショップに限定します。そのタイプのメタフィールドを複数追跡している場合は、2つ目の条件として、metafieldKeyがcustom.holiday_noticeと等しいことを追加してください。 - 必要なアクションを追加してください。この例では、旧値と新値を記載した社内メールを送信します。

例から始めましょう
- このページの下部に添付されている
.flowファイルをダウンロードしてください。 - Shopifyの管理画面で「Shopify Flow」を開き、「インポート」をクリックしてファイルを選択してください。
- 「内部メールを送信」ステップを開き、受信者を入力してください。このファイルには、意図的にアドレスが記載されていません。
- ワークフローを有効にしてください。
自分だけのものにしましょう
- メール内で
metafield.previousValueとmetafield.valueを使用し、以前の通知と新しい通知を表示してください。 - 「HTTPリクエストを送信」機能を使用して、変更内容をチームチャットに投稿してください。
- 複数のショップメタフィールドを追跡する場合は、
metafieldKeyに条件を追加してください。
反応の速さ
Shopifyからはこの件に関する通知は送信されませんので、アプリは追跡対象のメタフィールドを約1分ごとに読み取ります。ワークフローは1~2分以内に実行される見込みです。
知っておくと便利です
- ストアごとに1つのストアレコードが存在するため、
resourceIdは常に同じ値になります。
続きを読む
- メタフィールドのトリガー:すべてのリソースタイプにおけるメタフィールド・トリガーの仕組みについて。
- イベント履歴とトラブルシューティング:アプリが送信したすべてのイベントを、旧値と新値とともに確認できます。
