転送元 - Shopify
    • PDF

    転送元 - Shopify

    • PDF

    記事の要約

    概要

    Shopifyのデータを転送する設定のヘルプページです。

    REST Admin APIからのマイグレーション

    Shopify REST Admin APIは、2024年10月1日をもってレガシーAPIとなりました。
    これに伴い、転送元Shopifyのデータ抽出方法は、Shopify GraphQL APIを用いる方法へと移行します。
    データ抽出方法の変更により、以下の変更が生じます。

    • 取得されるデータのカラム名の変更
    • 新たに取得されるデータの追加

    REST Admin APIを利用したコネクター(転送元Shopify(廃止予定))時点から取得できた取得項目に関してのカラム名の変更については、Shopify公式ドキュメントを参照ください。
    下記のRest Admin APIのドキュメントのPropertiesでは、GraphQL Admin APIでのパラメーター名が対応する形で説明されています。

    制約

    複数ジョブの同時実行について

    データの転送には、GraphQL Admin APIのBulk operationを使用しています。
    ShopifyのBulk operationの仕様として、複数のoperationを同時に実行できません。このため、TROCCO上でも複数のジョブの並列実行を保証していません。
    ワークフローを用いて、順番にジョブが実行するように設定してください。

    プレビュー時の注意事項

    一部ターゲットを選択した際に、転送設定STEP2のプレビュー画面にダミーデータを元にした結果が表示されることがあります。

    設定項目

    STEP1 基本設定

    項目名必須内容
    Shopify接続情報あらかじめ登録してあるShopify接続情報から、今回の転送設定に必要な権限を持つものを選択します。
    ターゲット取得対象を選択します。
    取得できる項目については、取得項目一覧を参照ください。

    フィルター条件

    選択したターゲットによっては、取得するデータをフィルタリングできます。

    項目名必須内容
    作成日時-created_atカラムの値を基準に、取得するデータの範囲を指定できます。
    更新日時-updated_atカラムの値を基準に、取得するデータの範囲を指定できます。
    注文日時-processed_atカラムの値を基準に、取得するデータの範囲を指定できます。
    注文ステータス-ターゲットがordersの場合に指定できます。
    入力できる値については、GraphQL Admin API - Orderstatusを参照ください。
    財務ステータス-ターゲットがordersの場合に指定できます。
    入力できる値については、GraphQL Admin API - Orderfinancial_statusを参照ください。
    フルフィルメントステータス-ターゲットがordersの場合に指定できます。
    入力できる値については、GraphQL Admin API - Orderfulfillment_statusを参照ください。
    StaffMemberのid取得-ターゲットがordersの場合に、取得データにGraphQL Admin API - StaffMemberidを含めるかどうかを選択できます。
    StaffMemberidを含めるには、Advanced以上のプランかつ、Shopifyアプリにread_usersscopeを追加する必要があります。
    公開日時-ターゲットがproductsの場合に指定できます。published_atカラムの値を基準に、取得するデータの範囲を指定できます。
    商品ステータス-ターゲットがproductsの場合に指定できます。
    入力できる値については、GraphQL Admin API - Orderstatusを参照ください。
    公開ステータス-ターゲットがproductsの場合に指定できます。
    入力できる値については、GraphQL Admin API - Orderpublished_statusを参照ください。
    オーナータイプ-ターゲットにmetafieldsを指定した場合に指定します。
    メタフィールドが紐づくGraphQL Admin API - OwnerTypeproductordercustomerから選択します。

    この記事は役に立ちましたか?