こらは2022 - 01バ,ジョンのShopify APIリリ,スに関する記事になります。最新機能を活用したアプリの品質向上と開発エクスペリエンスの合理化に役立つ情報をお届けします。
今回のバ,ジョンに含まれるのは,店面APIによる改良された商品フィルタリング機能,刷新された产品分类API,コレクション·顧客·注文に関する新たなメタフィ,ルドの定義,订单发票API、BulkMutationsに関する新しいエラーコード,翻訳可能なリソース・フィーチャー画像・バーコードを取得する簡易的な方法などです。
また,今回のリリ,スにより2021 - 01バ,ジョンが削除となりますので,APIヘルスレポ,トをチェックして,今後の変更のレビュ,と互換性の確認をお願いします。このバ,ジョンに関連するすべてのAPI変更のリストは,2022 - 01リリ,スノ,ト(英語)に記載されています。
目次
1店面APIを使用したコレクション内の商品フィルタリング
2产品分类API
3.コレクション·顧客·注文におけるメタフィ,ルドの定義
4订单发票API
5批量突变APIのエラ,コ,ド
6複数の翻訳可能リソ,スをIDで取得する方法
7新たな店面APIの商品フィ,ルド
1店面APIを使用したコレクション内の商品フィルタリング
2022 - 01バージョンから,コレクション内の商品のフィルタリングが可能となり,お客さまに表示する検索結果を絞り込めるようになりました。コレクションに属する商品を取得後,ベンダーや商品タイプ,バリエーションのオプション,在庫の有無といった基準で商品にフィルターをかけられます。
これらのフィルターは組み合わせることも可能なので,より複雑な特性に基づいてコレクションの商品を取得できます。
たとえば,以下のクエリは,下記の属性をすべても商品の取得方法を示しています。
- 类型:衬衫和上衣
- 供应商:Bestshop
- 颜色:非常佩里
変数がこら。
コレクション内の商品にフィルターをかけることは,お客さまに関連性が一番高い商品を表示する素晴らしい方法です。店面APIを使用してコレクション商品をフィルタリングするための詳しい情報は,こらのドキュメント(英語)でご確認いただけます。
2产品分类API
マチャントのストアフロントにある商品をお客さまが見けやすいように整理するなら,新しい产品分类APIを使うのがお勧めです。StandardizedProductTypeは定義済みの商品カテゴリ(英語)であり,ストアフロントの商品の探しやすさを向上させます。また,標準のセットタ脸谱网などのチャネルにマ,チャントが商品掲載するのを簡単にしています。
事前定義されたカテゴリにフィットしない商品タプがある場合,商品オブジェクトのcustomProductTypeフィ,ルド(英語)を使用することができます。これは従来の类型フィ,ルド同様,文字列です。このカスタムプロダクトタプは,親カテゴリが商品に合致するのであれば,親のStandardizedProductTypeと一緒に使用することも可能です。
以下のクエリは,任意のStandardizedProductTypeを取得する例です。
レスポンスです。
商品分類(产品分类)に関する詳しい情報は,開発者ドキュメントをご覧ください。
3コレクション·顧客·注文におけるメタフィ.ルドの定義
2021年7月版で,商品のカスタムメタフィ,ルドタ,プを可能にするメタフィ,ルドのアップデ,トがリリ,スされました。今回のバ,ジョンではこの機能のサポ,トを,コレクション(集合)、顧客(客户)、注文(订单)に拡大しました。これらの新しいリソ,スにおけるメタフィ,ルドは,18種類のデタタプ(英語)を検証する働きも担うため,アプリやストアフロントで表示する有効なデ,タを保存できます。
以下の例は,商品のレファレンスを保存する顧客メタフィールドの定義を作成するリクエストを示しています。
変数です。
メタフィ,ルドの定義の詳細と,改良された类型システムへの移行に関する詳細は,開発者ドキュメント(英語)をご参照ください。
4订单发票API
ShopifyのAPIによって注文に対するンボスを送信する新しいミュテションがアプリに追加されました。orderInvoiceSend(英語)ミュ,テ,ションによって,注文IDとメール内容を提供し,決済が必要な注文の支払いをお願いするメールをお客さまに直接送ることができます。これは今までマ,チャントがマニュアルでおこなっていた作業ですが,自動化することが可能になりました。
お客さまに▪▪ンボ▪▪スを送るミュ▪テ▪ションの例がこ▪らです。
変数の例です。
このリクエストによってお客さまに送られるメ,ルが以下になります。
このメ,ルはチェックアウトに直にリンクされているため,お客さまは注文の支払いを簡単に完了できます。
orderInvoiceSendミュテションによるンボス送信の詳細は,ドキュメント(英語)でご確認いただけます。
5批量突变APIのエラ,コ,ド
今まで,BulkMutationsが表示するエラ,コ,ドは“大部分突变用户错误代码”のみでした。今回のバ,ジョンから,この汎用エラ,コ,ドの代わりに,何が間違っているかがすぐにわかる詳細な新しい5のエラコドが提供されます。
この新しいエラ,コ,ドの完全リストは,開発者ドキュメント(英語)にあります。
リマ电子邮箱ンドになりますが,10秒以上の連続したAPIリクエストが必要な場面ではBulkMutation APIがデ,タをShopifyに同期させるうえで最速か一番効率的な方法となります。BulkMutation APIを使ってShopifyにデ,タを同期する方法の詳細は,ドキュメント(英語)をご覧ください。
6複数の翻訳可能リソスをidで取得する方法
一連の特定IDに紐づく翻訳可能なリソ,スを取得する場合,今までは一度に1のリソスを得るリクエストを複数回おこなう必要がありました。2022 - 01バ,ジョンからは,IDの配列を使うことで,指定した一連の翻訳可能リソ,スを取得することが可能となりました。特定タプのリソスをすべて取得したり,IDごとに個別のリクエストをしたりせずに済みます。
以下の例は,特定商品の翻訳可能リソ,スを取得するリクエストと,単一リクエストの2のバリエションを示しています。
translatableResourcesByIdsクエリにいては,こらのドキュメント(英語)で詳しい情報を確認できます。
7新たなStorefront APIの商品フィ,ルド
2022 - 01バ,ジョンから,店面APIは商品のフィ,ルドを新しく2サポトします。featuredImageフィ,ルドは任意の商品のフィ,チャ,画像を素早く効率的に取得し,ProductVariant条形码はバリエ,ションのバ,コ,ドを取得できます。
この新しいフィルドを両方得るためのクエリ例がこらです。
レスポンスです:
最新の変更を確認しましょう
Shopifyプラットフォ,ムの変更全部を確認するには,プロダクトアップデ,トのメ,ンソ,スである開発者チェンジログ(英語)の購読がおすすめです。開発者チェンジログで最新の情報を得て、2020 - 04バ,ジョンのリリ,ス候補に新機能が搭載されたらすぐに採用し,一歩先を行きましょう。
パトナと開発者向けのマンスリShopifyニュ,スレタ,を購読することで,プラットフォ,ムの最新の変更情報を得ることもできます。
原文:Shayne Parmelee翻訳:深津望