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

このページは機械翻訳により提供されています。翻訳内容と英語版に相違がある場合は、英語版が優先されます。

更新内容

2023年4月に、使用しているShopify APIバージョンを最新の安定版2022-07バージョンにアップグレードします。 その後、このようなアップグレードを年に1回実施します。

なぜこれを行うのですか?

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

リリースされたバージョンが1年を経過すると、Shopifyはそのバージョンの維持を終了し、そのバージョンを要求するAPIコールは、現在サポートされている最も古い安定版バージョンに自動的にルーティングされます。

たとえば、現在利用可能な安定版バージョンが2021-012021-042021-072021-10の場合、2020-04バージョンを要求するAPIコールはすべて、Shopifyによって2021-01バージョンに自動的にルーティングされます。

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

詳細については、ShopifyのAPIバージョニングページを参照してください。

自分への影響

重要なアクション項目

重要なお知らせ

次の変更は、2023年3月27日より前に必ず実施する必要があります。

  1. フルフィルメント用のスコープを追加: “Create fulfillment”オーダーを使用している場合は、次のスコープをコネクションに追加してください:
  • 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

2022年第3四半期にリリースした新しい認証方法のいずれかを使用してShopifyに再接続する必要がある場合があることに注意してください。

上記に加えて、次について以下の変更を行うことをお勧めします:

  1. Create fulfillment: Shopifyは、fulfillmentOrderベースのアーキテクチャに移行するため、このアクションのエンドポイントを削除します。 残念ながら、廃止の確認が行われたのは2023年1月になってからでした。 Shopifyの新しいフルフィルメントオーダーベースのアーキテクチャに合わせた新しい“Create fulfillment”アクションをリリースしました。 古い“Create fulfillment”アクションを使用している実行中のレシピは、できるだけ早く新しいアクションに移行してください。 詳細については、このShopify Communityの投稿を参照してください。

  2. Create transaction: 2つの任意フィールド、authorizationおよびparent IDを追加します。 これらは任意ですが、省略するとオーダー編集アプリも使用している場合にエラーが発生する可能性があるため、上記のパラメーターのうち少なくとも1つを指定することをお勧めします。 サポートされる新しいフィールドサポートされる新しいフィールド

その他の注意事項

  1. カスタムアクション: すぐに対応する必要はありませんが、Shopifyではバージョン2022-07以降、XML応答形式が削除されることをお知らせします。 つまり、pathパラメーターで指定したAPIバージョンに関係なく、XML応答を想定するリクエストでは404エラーが発生し、XMLペイロードを送信するリクエストでは415エラーが発生します。

最終更新日: