Skip to main content
Upcart パブリック API を使用すると、開発者でも初心者でも、カートのカスタマイズ、ワークフローの自動化、サードパーティアプリとの統合を行うことができます。
このガイドでは基本を順を追って説明し、cart drawer 内でカスタム機能の構築を始められるようにサポートします。
👉 Upcart パブリック API の完全なドキュメントを見る

概要

パブリック API は、次のことを可能にする JavaScript 関数とイベントリスナーのコレクションです:
  • カートの変更に反応する — アイテムが追加、削除、更新されたことを検知します。
  • アクションをトリガーする — カートをプログラムで開閉するなど。
  • カスタム機能を構築する — 独自のロジックや UI コンポーネントを cart drawer 内に直接組み込みます。
これは特に、Upcart エディターの Custom HTML セクションで作業する際に役立ちます。これらの関数を使用して、購入者向けのユニークな体験を作成できます。

始めるために必要なもの

Upcart の API を使用する前に、次のものを用意してください:
  • Shopify ストアでの Upcart へのアクセス
    Upcart がストアにインストールされ、有効になっていることを確認します。
  • JavaScript の基本的な理解
    多くのカスタマイズでは既成のスニペットを使用しますが、基本を超えたことをしたい場合は、JavaScript の基礎知識が役立ちます。

最初の Upcart API スクリプトを追加する

Upcart エディターからすぐに API を使い始めることができます:
  1. Upcart Editor → Settings → Custom HTML → Scripts (before load) に移動します
  2. スクリプトを貼り付けます — 例:
注: window.upcartOnAddToCart を使用する古い例は引き続き動作しますが、非推奨であり、コンソールに警告が記録されます。新しいスクリプトにはすべて upcartSubscribeAddedToCart を使用してください。
  1. 変更を保存してから、ストアでテストします:
  • デベロッパーツールを開きます(Windows では F12 または Ctrl + Shift + J、Mac では Cmd + Option + J)
  • 商品をカートに追加します
  • Console タブで次のメッセージを確認します:
    "You just added [product title] to your cart!"
🎉 このメッセージが表示されれば、最初の API スクリプトは正常に動作しています!

カートのカスタマイズを始める

セットアップが完了したので、API を使ってさまざまな便利なことができます。アイテムが追加されたときにカートを自動的に開いたり、カスタムウィジェットを更新したり、分析イベントを送信したりできます。 関数の完全なリファレンスと例については、Upcart パブリック API ドキュメント をご覧ください。

その他のリソース