Shopify - APIバージョンの2022-07へのアップグレード
更新内容
2023年4月に、使用しているShopify APIバージョンを最新の安定版2022-07バージョンにアップグレードします。 その後、このようなアップグレードを年に1回実施します。
なぜこれを行うのですか?
Shopifyでは通常、3か月ごとに新しいバージョンがリリースされ、各リリースバージョンは最大12か月間維持されます。 つまり、常に4つの安定版バージョンがサポートされることになります。
リリースされたバージョンが1年を経過すると、Shopifyはそのバージョンの維持を終了し、そのバージョンを要求するAPIコールは、現在サポートされている最も古い安定版バージョンに自動的にルーティングされます。
たとえば、現在利用可能な安定版バージョンが2021-01、2021-04、2021-07、2021-10の場合、2020-04バージョンを要求するAPIコールはすべて、Shopifyによって2021-01バージョンに自動的にルーティングされます。
利便性とShopifyが義務付けるバージョンアップグレードのバランスを取るため、アップグレードは年に1回実施することにしました。 特定のAPIバージョンが必要な場合は、カスタムアクションを使用して、pathパラメーター内のデフォルトバージョンを上書きできます。
詳細については、ShopifyのAPIバージョニングページを参照してください。
自分への影響
重要なアクション項目
重要なお知らせ
次の変更は、2023年3月27日より前に必ず実施する必要があります。
- フルフィルメント用のスコープを追加: “Create fulfillment”オーダーを使用している場合は、次のスコープをコネクションに追加してください:
read_assigned_fulfillment_orderswrite_assigned_fulfillment_ordersread_merchant_managed_fulfillment_orderswrite_merchant_managed_fulfillment_ordersread_third_party_fulfillment_orderswrite_third_party_fulfillment_orders
2022年第3四半期にリリースした新しい認証方法のいずれかを使用してShopifyに再接続する必要がある場合があることに注意してください。
推奨されるアクション項目
上記に加えて、次について以下の変更を行うことをお勧めします:
Create fulfillment: Shopifyは、
fulfillmentOrderベースのアーキテクチャに移行するため、このアクションのエンドポイントを削除します。 残念ながら、廃止の確認が行われたのは2023年1月になってからでした。 Shopifyの新しいフルフィルメントオーダーベースのアーキテクチャに合わせた新しい“Create fulfillment”アクションをリリースしました。 古い“Create fulfillment”アクションを使用している実行中のレシピは、できるだけ早く新しいアクションに移行してください。 詳細については、このShopify Communityの投稿を参照してください。Create transaction: 2つの任意フィールド、
authorizationおよびparent IDを追加します。 これらは任意ですが、省略するとオーダー編集アプリも使用している場合にエラーが発生する可能性があるため、上記のパラメーターのうち少なくとも1つを指定することをお勧めします。
サポートされる新しいフィールド
その他の注意事項
- カスタムアクション: すぐに対応する必要はありませんが、Shopifyではバージョン
2022-07以降、XML応答形式が削除されることをお知らせします。 つまり、pathパラメーターで指定したAPIバージョンに関係なく、XML応答を想定するリクエストでは404エラーが発生し、XMLペイロードを送信するリクエストでは415エラーが発生します。
最終更新日: