みなさんこんにちは。リワイア加藤です。
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種類のカラースキーマを別々のセクションで利用できるように
カスタムデータ関連
- 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に統一