# Terminal を構成する

Terminal Configuration オブジェクトを使用して、リーダーに設定を適用します。

Terminal の [Configuration](https://docs.stripe.com/api/terminal/configuration.md) オブジェクトには、[スプラッシュ画面](https://docs.stripe.com/terminal/fleet/splash-screen.md)、[チップ処理設定](https://docs.stripe.com/terminal/fleet/tipping.md)、[オフライン モード](https://docs.stripe.com/terminal/fleet/offline-mode.md)など、リーダーに関連するすべての設定が含まれます (具体的な手順とオプションについては、個人設定ガイドを参照してください)。

これらの設定は階層的であるため、アカウントレベルまたは個人の店舗レベルで設定を適用できます。設定は次の方法で行うことができます:

- 個人[店舗](https://docs.stripe.com/api/terminal/locations.md): その店舗に登録されているすべてのリーダーに適用されます
- アカウントレベル: すべてのリーダーに一括適用されます

アカウントレベルの設定を店舗レベルの設定で上書きできます。店舗レベルで設定を行わない場合は、アカウントレベルの設定が適用されます。

> ゾーンの設定作成はプライベートプレビューで行います。プレビューへの参加をリクエストされる場合、[メールでお問い合わせください](mailto:terminal-zones-configuration-preview@stripe.com)。

たとえば、`Configuration` オブジェクトを次のようにモデル化できます。
![Configuration の階層](https://b.stripecdn.com/docs-statics-srv/assets/configuration-object-tree.5ec745ad57500a800c4f34f0a970224e.png)

このシナリオでは、店舗 3 はアカウントの「デフォルト設定」から設定を継承して、店舗 1 と 2 はそれぞれ独自に設定されています。

> 店舗レベルで設定を行わない場合、店舗はアカウントのデフォルト設定を継承します。たとえば、Location でスプラッシュスクリーンを設定しない場合は、アカウントレベルで設定されたデフォルト設定から継承されます。

API またはダッシュボードを使用して行われた設定変更は、対象のリーダーに反映されるまでに最大 10 分かかることがあります。

# ダッシュボード

> This is a ダッシュボード for when dashboard-or-api is dashboard. View the full page at https://docs.stripe.com/terminal/fleet/configurations-overview?dashboard-or-api=dashboard.

Stripe ダッシュボードで設定を表示して管理することができます。設定を管理するには、リーダータブの**店舗を管理する**をクリックします。Stripe は、設定のリストをページの右側に表示します。その他の設定を表示するには、リストの下部にある**もっと表示**をクリックします。

## アカウントのデフォルトの構成を更新する

1. **すべての店舗**リストアイテム (上部) のオーバーフローメニュー (⋯) を選択します。
1. **設定を編集**をクリックします。
1. 更新する設定タイプごとに**上書きする**をクリックします。
1. **変更を適用する**をクリックします。

すべての店舗のすべてのリーダーは、店舗の設定に上書きが設定されていない限り、お客様が設定した設定を継承します。設定を追加すると、リーダーは 10 分以内に更新されます。

## 店舗の新しい設定を作成する

#### 店舗の詳細ページから

1. [Terminal Locations](https://dashboard.stripe.com/terminal/locations) ページで、店舗をクリックして店舗の詳細ページに移動します。
1. **継承された設定** で、更新する設定タイプの編集アイコン (✏) をクリックします。
1. 設定の名前を入力します。この名前は複数回使用できます。
1. 設定タイプの設定を入力します。
1. **変更を適用する**をクリックします。

#### 店舗管理ページから

1. 店舗アイテムのオーバーフローメニュー (⋯) を選択します。
1. **設定を追加**をクリックします。
1. 設定の名前を入力します。この名前は複数回使用できます。
1. 更新する設定タイプごとに**上書きする**をクリックします。
1. **変更を適用する**をクリックします。

その店舗のすべてのリーダーが、お客様が設定した設定を継承します。設定を追加すると、リーダーは 10 分以内に更新されます。

## 既存の設定を更新する

#### 店舗の詳細ページから

1. [Terminal Locations](https://dashboard.stripe.com/terminal/locations) ページで、店舗をクリックして店舗の詳細ページに移動します。
1. **ローカル設定** または **継承された設定** で、更新する設定タイプの編集アイコン (✏) をクリックします。
1. 設定タイプの設定を入力します。
1. **変更を適用する**をクリックします。

#### 店舗管理ページから

1. 店舗のリストアイテム (左側) または設定自体 (右側) のいずれかで、オーバーフローメニュー (⋯) を選択します。
1. **設定を編集**をクリックします。
1. 更新する設定タイプごとに**上書きする**をクリックします。
1. **変更を適用する**をクリックします。

店舗のすべてのリーダーは 10 分以内に更新されます。

## 既存の設定を削除する

#### 店舗の詳細ページから

1. [Terminal Locations](https://dashboard.stripe.com/terminal/locations) ページで、店舗をクリックして店舗の詳細ページに移動します。
1. **ローカル設定** の横にある **削除** をクリックします。
1. **削除** をクリックします。

#### 店舗管理ページから

1. 店舗のリストアイテム (左側) または設定自体 (右側) のいずれかで、オーバーフローメニュー (⋯) を選択します。
1. **設定を削除**をクリックします。

設定を削除した後、その店舗のリーダーは、10 分以内にアカウントのデフォルト設定に戻ります。


# API

> This is a API for when dashboard-or-api is api. View the full page at https://docs.stripe.com/terminal/fleet/configurations-overview?dashboard-or-api=api.

## アカウントのデフォルト構成を取得する

Stripe は、アカウントにデフォルトの構成を自動的に提供します。階層を設定する際に、店舗レベルで確立されなかった設定は、デフォルトの構成から設定を継承します。デフォルトの構成を店舗に直接適用することはできません。アカウントのデフォルト設定を取得するには、[設定取得](https://docs.stripe.com/api/terminal/configuration/retrieve.md)リクエストを使用します。

```curl
curl -G https://api.stripe.com/v1/terminal/configurations \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d is_account_default=true
```

## 個々の店舗の設定を作成する

`Configuration` オブジェクトを作成するには、[create configuration (設定作成)](https://docs.stripe.com/api/terminal/configuration/create.md) リクエストを使用します。

```curl
curl https://api.stripe.com/v1/terminal/configurations \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "bbpos_wisepos_e[splashscreen]=file_1KjBJdE7XUJuZdf0F6GgO9uY"
```

店舗に割り当てるには、以前に作成した `Configuration` オブジェクトを [update location](https://docs.stripe.com/api/terminal/locations/update.md) リクエストに指定します。

```curl
curl https://api.stripe.com/v1/terminal/locations/tml_DPJxAAnxbn3JQz \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d configuration_overrides=tmc_EjHtMwLT8HmATT
```

## 既存の設定を更新する

`Configuration` オブジェクトを更新するには、[update configuration (設定更新)](https://docs.stripe.com/api/terminal/configuration/update.md) リクエストを使用します。

```curl
curl https://api.stripe.com/v1/terminal/configurations/tmc_EjHtMwLT8HmATT \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "bbpos_wisepos_e[splashscreen]=file_1KjBJdE7XUJuZdf0F6GgO9uY"
```

## 設定を削除する

`Configuration` オブジェクトを削除するには、[delete configuration (設定削除)](https://docs.stripe.com/api/terminal/configuration/delete.md) リクエストを使用します。

```curl
curl -X DELETE https://api.stripe.com/v1/terminal/configurations/tmc_EjHtMwLT8HmATT \
  -u "<<YOUR_SECRET_KEY>>:"
```