【一言解説】Shopify 2024-04 技術アップデート

みなさんこんにちは。リワイア加藤です。

Shopifyでは3ヶ月に1回新しいAPIのリリースが行われます。今回は2024年4月公開の「2024-04」バージョンで新しく公開されたアップデートを、公式のDerveloper changelogから一言解説を添えて紹介していきます。

4月1日から5日にかけて公開されたアップデートは「34件」でした。カテゴリごとに分類してみましたので、ぜひ気になったものを個別に確認してみてください。

商品関連

New optional argument to include translations when duplicating product asynchronously 

  • 商品情報の複製を行う際に商品、バリエーション、メタフィールドの翻訳を含めるかどうかの設定が可能に

Metafield-linked product options

  • GraphQL Admin API version 2024-04から商品オプションを追加・編集することができるように

ACTION REQUIRED
Deprecation timelines related to new GraphQL product APIs

  • GraphQL product APIの更新に伴い、各種アプリのAPIの更新が必要に(更新までのタイムライン、方法について共有)

New GraphQL product APIs that support up to 2000 variants now available in 2024-04

  • 新しいGraphQL product APIが正式リリースされ、バリデーションの数が100から2000に変更。また、オプションの変更についてAPIが拡充

ACTION REQUIRED
Inventory Mutations and Fields Removal

  • Inventoryオブジェクトの一部フィールドが削除

ACTION REQUIRED
Taxonomy API

  • 商品を分類する新しいAPI「Taxonomy API」がリリース
  • 「queryRoot.productTaxonomy」「queryRoot.productTaxonomyNodes」廃止と一部のAPIに変更も

ACTION REQUIRED
Removal of `productDuplicateAsync` mutation from the GraphQL Admin API

  • 非推奨だったproductDuplicateAsyncが削除

 

Shopify POS関連

Query cash transactions for a Shopify POS cash tracking session

  • POSでの取引において現金取引の履歴が作成されるように

 

ディスカウント関連

CartDiscountCode#code has been fixed to be case insensitive

  • ディスカウントコードが大文字小文字を区別しない形式に修正

 

管理画面関連

Expanded targets for Admin Action Extensions

  • Admin Action Extensionsに複数の設置箇所が追加(下書き注文ページ、カゴ落ちページなど)

 

Storefront API関連

Cart checkoutChargeAmount returns amount before the discounts

  • Cart.cartCost.checkoutChargeAmountにディスカウントが含まれていたのを修正

Storefront API now supports per-market Fulfillable Inventory

  • マーケットごとに出荷可能な在庫を指定できるように

ACTION REQUIRED
Update note to be required in cartNoteUpdate

  • GraphQL Storefront APIにおいてcartNoteUpdate APIにnote属性が必須項目に

New Storefront GraphQL APIs for B2B are available in 2024-04

  • B2B利用時に顧客企業ごとの価格取得が可能に

 

バリデーション関連

ACTION REQUIRED
Preloaded Cart and Checkout Validation configuration in Admin UI extensions

  • Admin UI extensionsのValidation APIにおいて事前にレコードとメタフィールドの値を読み込みできるように
  • アクセススコープの追加が今後必要に

New access scopes added to the Validation GraphQL Admin API 

  • GraphQL Admin APIに新しくバリデーション関連のスコープが追加

 

フルフィルメント関連

New sort options for fulfillment orders

  • GraphQL Admin API version 2024-04からfulfillmentOrdersのクエリにsortのオプションが追加

Fulfillment Orders Searching and Sorting by `updated_at` field

  • GraphQLにおいてFulfillment Ordersの検索に「UPDATED_AT」が指定できるように

ACTION REQUIRED
Deprecation of the `fulfillmentService.fulfillmentOrdersOptIn` field

  • GraphQL、REST APIにおいてFulfillmentServiceのfulfillmentOrdersOptInフィールドが非推奨に

ACTION REQUIRED
New Create Fulfillment Request Validation

  • GraphQL、RESTで同一のline_items_by_fulfillment_orderにおいてfulfillment_order_idが重複してできないバリデーションが追加

New `inventory_management` boolean argument on `fulfillmentServiceUpdate`mutation

  • GraphQL「fulfillmentServiceUpdate」mutationにて「inventory_management」を指定しての更新が可能に

Adding additional value to FulfillmentOrderAssignmentStatus

  • アプリ経由のフルフィルメントにおいてfulfillmentOrderにステータスフィールドが追加

 

顧客関連

Company and CompanyLocation metafields are now available in the Customer Account API

  • Customer Account APIから会社、会社のロケーションのメタフィールドにアクセス可能に

ACTION REQUIRED
Removal of Customer order-related sort keys on Admin API

  • Admin APIにおいて顧客のLAST_ORDER_DATE, ORDERS_COUNT, TOTAL_SPENTでの並べ替えが非推奨に

Customer APIs: Allow querying of customer subscription contracts

  • GraphQLのCustomer APIから顧客の定期購入の情報を取得できるように

 

カート/チェックアウト関連

ShippingLineInput now accepts priceWithCurrency

  • ShippingLineInputにpriceWithCurrencyが適用可能に

Set LineItem attributes using CartTransform

  • CartTransformからLineItem attributesがセットできるようになり、バンドルアイテムへcustom attributeを設定できるように

ACTION REQUIRED
Deprecation of Checkout APIs

  • Checkout APIが非推奨に変更予定(Storefront Cart API、Checkout Sheet Kitを今後は利用)

[Checkout Branding API] Initial release of header and footer style customizations

  • チェックアウトのヘッダー/フッターを更新するmutationがリリース。チェックアウトのヘッダー/フッターの色やスペースを変更可能に

[Checkout Branding API] New color schemes

  • チェックアウトのカラースキーマのプリセットが追加。schema3、schema4が追加され、最大4種類のカラースキーマを別々のセクションで利用できるように

 

カスタムデータ関連

Introducing metafieldsDelete

  • metafieldsDelete mutationが利用可能になり、一度に25件のメタフィールドが削除可能に

 

定期購入関連

ACTION REQUIRED
New Error codes and updated error code mapping for payment and billing

  • 定期購入時の決済時のエラーコードが追加

 

その他

ACTION REQUIRED
Unification of count fields

  • 各種リソースのカウントフィールドの仕様が変更に

ACTION REQUIRED
`receipt` removed from OrderTransaction GraphQL Admin API

  • OrderTransaction GraphQL Admin APIから「receipt」フィールドが削除され、receiptJsonに統一