> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Upcart のパブリック API の概要

> Upcart の API の使い始め方、スクリプトの追加、変更のテスト、カートのカスタマイズを簡単に行う方法を学びます。

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

👉 [Upcart パブリック API の完全なドキュメントを見る](https://rokt.notion.site/upcart-public-api)

***

<div id="overview">
  ## 概要
</div>

パブリック API は、次のことを可能にする JavaScript 関数とイベントリスナーのコレクションです:

* **カートの変更に反応する** — アイテムが追加、削除、更新されたことを検知します。
* **アクションをトリガーする** — カートをプログラムで開閉するなど。
* **カスタム機能を構築する** — 独自のロジックや UI コンポーネントを cart drawer 内に直接組み込みます。

これは特に、Upcart エディターの **Custom HTML** セクションで作業する際に役立ちます。これらの関数を使用して、購入者向けのユニークな体験を作成できます。

***

<div id="what-you-need-to-get-started">
  ## 始めるために必要なもの
</div>

Upcart の API を使用する前に、次のものを用意してください:

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

***

<div id="adding-your-first-upcart-api-script">
  ## 最初の Upcart API スクリプトを追加する
</div>

Upcart エディターからすぐに API を使い始めることができます:

1. **Upcart Editor → Settings → Custom HTML → Scripts (before load)** に移動します

2. スクリプトを貼り付けます — 例:

```
<script>
  window.upcartSubscribeAddedToCart(function(event) {
    console.log("You just added " + event.item.title + " to your cart!");
  });
</script>
```

**注:** `window.upcartOnAddToCart` を使用する古い例は引き続き動作しますが、非推奨であり、コンソールに警告が記録されます。新しいスクリプトにはすべて `upcartSubscribeAddedToCart` を使用してください。

3. 変更を保存してから、ストアでテストします:

* デベロッパーツールを開きます(Windows では `F12` または `Ctrl + Shift + J`、Mac では `Cmd + Option + J`)
* 商品をカートに追加します
* Console タブで次のメッセージを確認します:\
  `"You just added [product title] to your cart!"`

🎉 このメッセージが表示されれば、最初の API スクリプトは正常に動作しています!

***

<div id="start-customizing-your-cart">
  ## カートのカスタマイズを始める
</div>

セットアップが完了したので、API を使ってさまざまな便利なことができます。アイテムが追加されたときにカートを自動的に開いたり、カスタムウィジェットを更新したり、分析イベントを送信したりできます。

関数の完全なリファレンスと例については、**[Upcart パブリック API ドキュメント](https://rokt.notion.site/upcart-public-api)** をご覧ください。

***

<div id="more-resources">
  ## その他のリソース
</div>

* 🧩 **[API FAQ](/ja/upcart/upcart_api_frequently_asked_questions)** — トラブルシューティングのヒントとよくある質問
* ⚙️ **[Upcart API の一般的な使い方](/ja/upcart/common_upcart_api_uses)** — 人気のコード例とテンプレート
* 💡 **[カスタマイズドキュメント](/ja/upcart/add_a_mandatory_terms_and_conditions_checkbox_to_your_cart)** — すぐに使える既成のスクリプト
* 🛍️ **[Shopify の Cart API ドキュメント](https://shopify.dev/docs/api/ajax/reference/cart)** — Shopify が舞台裏でカートデータをどのように処理するかを学べます
* 👩💻 高度なカスタマイズが必要ですか? より複雑な統合については、[Shopify エキスパート](https://www.shopify.com/ca/partners/directory/services/development-and-troubleshooting/custom-apps-integrations)への依頼を検討してください。