こんにちは。プロダクトチームの周です。
Shopify REST Admin API は2024年10月1日をもってレガシーとなったことに伴い、Shopify 連携のCData 製品でご利用のデータモデルについて、「REST Data Model」から「GRAPHQL Data Model」への移行を強くお勧めいたします。REST とGRAPHQL データモデルでは、利用可能なテーブル、ビュー、ストアドプロシージャに仕様上の違いが数多くありますため、GRAPHQL への移行に際しては、これらの違いを十分にご確認いただいた上で、計画的な移行を実施していただく必要があります。本記事ではGRAPHQL への移行による主な変更点（Fulfillment,Inventory,Customers関連）を案内いたします。
※Productsに関連する主な変更点はこちらのブログ記事をご参照ください。
※Ordersに関連する主な変更点はこちらのブログ記事をご参照ください。
◆ Fulfillments (REST) → (GRAPHQL) Fulfillments
REST-2025-04.
Fulfillments | GRAPHQL-2025-04.
Fulfillments | GRAPHQLに関する注記 |
FulfillmentOrderId | FulfillmentOrders.Id | FulfillmentOrders.OrderId = Fulfillments.OrderId |
Id | Id , LegacyResourceId | GRAPHQLの「Id」はRESTと異なるフォーマットを持つグローバルID。 |
LineAggregate | OrderLineItems.* | |
LocationId | Locations.LegacyResourceId | Locations.Id = Fulfillments.LocationId |
NotifyCustomer | NotifyCustomer | 疑似カラム |
OrderCreatedAt | Orders.CreatedAt | Orders.Id = Fulfillments.OrderId |
OrderId | Orders.LegacyResourceId | Orders.Id = Fulfillments.OrderId |
OrderUpdatedAt | Orders.UpdatedAt | Orders.Id = Fulfillments.OrderId |
Receipt | ✕ (GRAPHQL未対応) | |
TrackingCompany | TrackingInfoCompany | |
TrackingNumbers | TrackingInfoNumber | |
TrackingUrls | TrackingInfoUrl | |
VariantInventoryManagement | ✕ (GRAPHQL未対応) | |
◆ FulfillmentOrders (REST) → (GRAPHQL) FulfillmentOrders
REST-2025-04.
FulfillmentOrders | GRAPHQL-2025-04.
FulfillmentOrders | GRAPHQLに関する注記 |
AssignedLocationId | AssignedLocationLocationLegacyResourceId | |
DeliveryMethodType | DeliveryMethodMethodType | |
FulfillmentHolds | 未対応 | |
Id | Id | GRAPHQLの「Id」はRESTと異なるフォーマットを持つグローバルID。 |
InternationalDuties | InternationalDutiesIncoterm | |
LineItems | OrderLineItems.* | |
MerchantRequests | 未対応 | |
OrderId | Orders.LegacyResourceId | Orders.Id = FulfillmentOrders.OrderId |
ShopId | ✕ (GRAPHQL未対応) | |
SupportedActions | 未対応 | |
◆ InventoryLevels (REST-2024-04より削除) → (GRAPHQL) InventoryItemInventoryLevels
REST-2024-01.
InventoryLevels | GRAPHQL-2025-04.
InventoryItemInventoryLevels | GRAPHQLに関する注記 |
Available | InventoryItemInventoryLevelQuantities.Quantity | WHERE InventoryItemInventoryLevelQuantities.Name = 'available' |
InventoryItemId | InventoryItems.LegacyResourceId | InventoryItems.Id = InventoryItemInventoryLevels.InventoryItemId |
LocationId | Locations.LegacyResourceId | Locations.Id = InventoryItemInventoryLevels.LocationId |
Operation | → ストアドプロシージャ
InventorySetQuantities
InventoryAdjustQuantities | |
UpdatedAt | InventoryItemInventoryLevelQuantities.UpdatedAt | WHERE InventoryItemInventoryLevelQuantities.Name = 'available' |
◆ Customers (REST) → (GRAPHQL) Customers
REST-2025-04.
Customers | GRAPHQL-2025-04.
Customers | GRAPHQLに関する注記 |
EmailMarketingLevel | EmailMarketingConsentMarketingOptInLevel | |
EmailMarketingState | EmailMarketingConsentMarketingState | |
EmailMarketingUpdatedAt | EmailMarketingConsentConsentUpdatedAt | |
Id | Id | GRAPHQLの「Id」はRESTと異なるフォーマットを持つグローバルID。 |
LastOrderName | Orders.Name | Customers.LastOrderId = Orders.Id |
OrdersCount | NumberOfOrders | |
State | State | GRAPHQLの場合は値が大文字表記。RESTは小文字 |
Tags | Tags | GRAPHQLの場合は値の形式が[Tag1, Tag2]、RESTはTag1,Tag2 |
TotalSpent | AmountSpentAmount | |
◆ CustomerAddresses (REST) → (GRAPHQL) CustomerAddresses
REST-2025-04.
CustomerAddresses | GRAPHQL-2025-04.
CustomerAddresses | GRAPHQLに関する注記 |
CountryName | Country | GRAPHQLの「Id」はRESTと異なるフォーマットを持つグローバルID。 |
CustomerUpdatedAt | Customers.UpdatedAt | Customers.Id = CustomerAddresses.CustomerId |
Default | ✕ (GRAPHQL未対応) | |
FirstName | Customers.FirstName | Customers.Id = CustomerAddresses.CustomerId |
Id | Id | Customers.Id = CustomerAddresses.CustomerId |
LastName | Customers.LastName | |
Name | CustomerName | |
おわりに
本記事ではShopify API とデータモデルのREST からGRAPHQL への移行による主な変更点（Fulfillment,Inventory,Customers関連）を紹介しました。全ての変更点を網羅したリストではありませんが、ご不明な点がございましたら、お気軽に弊社サポートデスクにお問い合わせください。引き続きCData 製品をShopify へのデータ連携でご活用ください。
CData Shopify Drivers は30日間の無償トライアルが可能です。ぜひお試しくださいませ。
https://jp.cdata.com/drivers/shopify
