Shopify - APIバージョンのアップグレード 2022-07

アップデート内容

2023年4月に、使用しているShopify APIバージョンを最新の安定版である2022-07にアップグレードします。その後、年に一度の頻度でアップグレードを行います。

なぜアップグレードするのか？

Shopifyは通常、3ヶ月ごとに新しいバージョンをリリースし、各リリースバージョンを最大12ヶ月間サポートします。つまり、常に4つの安定版がサポートされています。

リリースされたバージョンが1年を超えると、Shopifyはそのバージョンのメンテナンスを終了し、そのバージョンを要求するAPI呼び出しは自動的に最も古い安定版にルーティングされます。

例えば、現在利用可能な安定版が2021-01、2021-04、2021-07、2021-10である場合、2020-04バージョンを要求するAPI呼び出しはShopifyによって自動的に2021-01バージョンにルーティングされます。

Shopifyの指定されたバージョンアップグレードに対して、利便性とのバランスを取るために、私たちは年に一度のアップグレードを実施することにしました。特定のAPIバージョンが必要な場合は、pathパラメーターでデフォルトのバージョンを上書きするためにカスタムアクションを使用できます。

詳細については、ShopifyのAPIバージョニング (opens new window)ページをご覧ください。

これが私にどのように影響するのか？

重要なアクションアイテム

重要なお知らせ

以下の変更を**2023年3月27日までに実施することが重要です**。

1. フルフィルメントのスコープを追加する: 「フルフィルメントの作成」オーダーを使用している場合は、以下のスコープを接続に追加してください：

• read_assigned_fulfillment_orders
• write_assigned_fulfillment_orders
• read_merchant_managed_fulfillment_orders
• write_merchant_managed_fulfillment_orders
• read_third_party_fulfillment_orders
• write_third_party_fulfillment_orders

なお、Q3 2022にリリースした新しい認証方法を使用してShopifyに再接続する必要がある場合があります。

推奨されるアクションアイテム

上記に加えて、以下の変更を行うことをおすすめします：

1. フルフィルメントの作成: Shopifyはこのアクションのエンドポイントを削除し、fulfillmentOrderベースのアーキテクチャに置き換えます。残念ながら、この廃止の確認は2023年1月になされました。私たちはShopifyの新しいフルフィルメントオーダーベースのアーキテクチャに合わせた新しい「フルフィルメントの作成」アクションをリリースしました。古い「フルフィルメントの作成」アクションを使用している実行中のレシピをできるだけ早く新しいアクションに移行してください。詳細については、このShopifyコミュニティの投稿 (opens new window)をご覧ください。

2. トランザクションの作成: 2つのオプションフィールド「authorization」と「parent ID」を追加します。これらはオプションですが、少なくとも上記のパラメーターのいずれかを指定することをおすすめします。これらを省略すると、注文編集アプリを使用している場合にエラーが発生する可能性があります。 サポートされる新しいフィールド

注意事項

1. カスタムアクション: 即時のアクションは必要ありませんが、Shopifyはバージョン2022-07以降でXMLレスポンス形式を削除する予定です。これは、pathパラメーターで指定したAPIバージョンに関係なく、XMLレスポンスを期待するリクエストは404エラーが発生し、XMLペイロードを送信するリクエストは415エラーが発生することを意味します。