# ダッシュボードで検索を実行する

ダッシュボードを使用して、支払いや顧客を検索できます。

[Stripe Sigma](https://docs.stripe.com/stripe-data.md) を使用すると、すべてのビジネスデータを対話型 SQL 環境としてダッシュボードで利用できるようになります。Sigma を使用して、高度な検索を実行したり、カスタマイズレポートを生成することもできます。

ダッシュボードの検索を使用して重要なリソースを見つけたり、*連結アカウント* (A person or business accepting payments or receiving payouts on a Connect platform)、*customers* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments)、*請求書* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice)、*入金* (A payout is the transfer of funds to an external account, usually a bank account, in the form of a deposit)、*製品* (Products represent what your business sells—whether that's a good or a service)など、さまざまな Stripe リソース間を移動できます。

検索を実行すると、上位の結果がすぐに表示されます。**すべての結果を表示**をクリックするか、**Enter キー**を押すと、すべての一致結果が表示されます。検索結果のグループで**すべて表示**をクリックすると、列見出しが展開されます。見出しの一部は並べ替えることが可能です。

## 始める

さまざまな情報を検索語句として使用します。

- カードまたは口座番号の末尾 4 桁 (**4242**)。
- 支払い方法のタイプ (**iDEAL**)。
- 連結された Stripe アカウントのビジネス名 (**Rocketship**)。
- メールの領収書番号 (**1817-9523**)。

日付が必要な検索では、**08/22**、**2020-07-12**、**先週**のように複数の形式を使用できます。オブジェクトの識別子 (不審請求の申請 ID) を使用して必要なオブジェクトに直接移動することもできます。多くの場合、検索に追加のコンテキストは不要です。検索クエリに基づき、ダッシュボードが自動的にもっとも関連性の高い情報を検索します。検索フィルターと演算子を使用して検索をより詳細に制御することもできます。

## 検索フィルタと演算子

ダッシュボードはデフォルトで、オブジェクト内の最も論理的なフィールドで検索語に一致する値を検索します (たとえば、`email` フィールドのメールアドレスやオブジェクトの説明を検索します)。フィルターと演算子を使用して検索をさらに絞り込むことができます。検索クエリに指定する語が多くなると、検索結果は少なくなります。

#### フィルタ

フィルターを使用して検索語句を限定し、対象となるオブジェクト内の特定のフィールドだけに適用されるようにします。これらのフィルターの 1 つを検索語の前に置きます。検索語にスペースを含める必要がある場合は、引用符で囲みます (`name:"John Doe"`)。フィールドの多くは複数のオブジェクト間で共通しています。たとえば `amount` フィールドは決済、請求書、入金などに適用されます。

| フィルター         | 説明                                                                                                                                                        | 例                                 |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- |
| `amount:`     | オブジェクトの金額。小数のある通貨では両方の通貨単位に小数点を使用します (例: ドルとセント)。                                                                                                         | **amount:149.99**                 |
| `brand:`      | オブジェクトに関連付けられたカードのブランド。                                                                                                                                   | **brand:visa**                    |
| `country:`    | オブジェクトに関連付けられた国を表す 2 文字の [ISO コード](https://en.wikipedia.org/wiki/ISO_3166-1)。                                                                             | **country:GB**                    |
| `created:`    | オブジェクトが作成された日付 (`date` と同じ)。                                                                                                                              | **created:2020/07/12**            |
| `currency:`   | オブジェクトに関連付けられた通貨を表す 3 文字の [ISO コード](https://en.wikipedia.org/wiki/ISO_4217) 。                                                                             | **currency:EUR**                  |
| `date:`       | オブジェクトが作成された日 (`created` と同じ)。                                                                                                                            | **date:yesterday**                |
| `email:`      | オブジェクトのメールアドレス (アドレスの全部または一部)。                                                                                                                            | **email:jenny.rosen@example.com** |
| `exp:`        | オブジェクトに関連付けられたカードの有効期限。                                                                                                                                   | **exp:08/22**                     |
| `flow:`       | [Sources](https://docs.stripe.com/sources.md) での支払いに適用される[顧客アクションのフロー](https://docs.stripe.com/sources.md#flow-for-customer-action)のタイプ。                  | **flow:redirect**                 |
| `last4:`      | オブジェクトに関連付けられたカードまたは口座番号の末尾 4 桁。                                                                                                                          | **last4:4080**                    |
| `metadata:`   | サポートされるオブジェクトの[メタデータ](https://docs.stripe.com/api.md#metadata)値。メタデータの追加の[検索オプション](https://docs.stripe.com/dashboard/search.md#metadata-searches)も利用できます。 | **metadata:555-5555**             |
| `name:`       | オブジェクトに関連付けられたカード保有者または顧客の名前。                                                                                                                             | **name:jenny**                    |
| `number:`     | 請求書を特定する一意の番号。                                                                                                                                            | **number:06b2b1a642-0023**        |
| `postal:`     | オブジェクトに関連付けられた郵便番号。                                                                                                                                       | **postal:12345**                  |
| `receipt:`    | 支払いまたは返金のメール領収書で使用される領収書番号。                                                                                                                               | **receipt:3330-2392**             |
| `risk_level:` | [Radar](https://docs.stripe.com/radar.md) で判定される支払いの[リスクレベル](https://docs.stripe.com/radar/risk-evaluation.md)。                                           | **risk\_level:elevated**          |
| `status:`     | オブジェクトのステータス。                                                                                                                                             | **status:canceled**               |
| `type:`       | 支払いの作成に使用する [PaymentMethod](https://docs.stripe.com/payments/payment-methods.md) または [Source](https://docs.stripe.com/sources.md) のタイプ。                   | **type:ideal**                    |
| `usage:`      | [Sources](https://docs.stripe.com/sources.md) での支払い方法で[使用状況](https://docs.stripe.com/sources.md#single-use-or-reusable)が利用できるかどうか。                        | **usage:single\_use**             |
| `zip:`        | オブジェクトに関連付けられた郵便番号。                                                                                                                                       | **zip:12345**                     |

#### 演算子

金額と日付を検索する際は、以下の演算子を使用して検索範囲を絞り込むことができます。

| 演算子  | 説明                     | 例                    |
| ---- | ---------------------- | -------------------- |
| `>`  | ある金額より大きいか、指定された日付より後。 | **amount:>149.99**   |
| `<`  | ある金額より小さいか、指定された日付より前。 | **date:<2020-07-12** |
| `..` | ある範囲内の日付や金額。           | **金額:50.00…99.99**   |

ブール演算子 `is:` を使用して、結果を特定のオブジェクトタイプまたは状態にフィルタリングすることもできます。

オブジェクトタイプを指定して `is:` と使用すると、そのタイプの結果のみが表示されます。

| 演算子                | 説明                                         | 例                        |
| ------------------ | ------------------------------------------ | ------------------------ |
| `account`          | 連結アカウント。                                   | **is:account**           |
| `charge`           | 支払い (`payment` と同じ)。                       | **is:charge**            |
| `checkout_session` | Checkout Session。                          | **is:checkout\_session** |
| `coupon`           | クーポン。                                      | **is:coupon**            |
| `credit_note`      | クレジットノート。                                  | **is:credit\_note**      |
| `customer`         | 顧客。                                        | **is:customer**          |
| `dispute`          | 不審請求の申し立て。                                 | **is:dispute**           |
| `document`         | 書類。                                        | **is:document**          |
| `invoice`          | 請求書。                                       | **is:invoice**           |
| `invoiceitem`      | 請求書アイテム。                                   | **is:invoiceitem**       |
| `order`            | 注文。                                        | **is:order**             |
| `payment`          | 支払い (`charge` と同じ)。                        | **is:payment**           |
| `payment_intent`   | PaymentIntent。                             | **is:payment\_intent**   |
| `payment_link`     | 決済用リンク。                                    | **is:payment\_link**     |
| `payment_method`   | PaymentMethod。                             | **is:payment\_method**   |
| `payout`           | 入金。                                        | **is:payout**            |
| `plan`             | サブスクリプションのプラン。                             | **is:plan**              |
| `price`            | 料金。                                        | **is:price**             |
| `product`          | 商品。                                        | **is:product**           |
| `promotion_code`   | プロモーションコード。                                | **is:promotion\_code**   |
| `quote`            | 見積もり。                                      | **is:quote**             |
| `refund`           | 返金。                                        | **is:refund**            |
| `setup_intent`     | SetupIntent。                               | **is:setup\_intent**     |
| `source`           | [ソース](https://docs.stripe.com/sources.md)。 | **is:source**            |
| `subscription`     | サブスクリプション。                                 | **is:subscription**      |
| `transfer`         | Stripe アカウント間の資金の移動。                       | **is:transfer**          |

状態を指定して `is:` を使用すると、その状態に一致する結果のみが表示されます。

| 演算子         | 説明                   | 例                |
| ----------- | -------------------- | ---------------- |
| `active`    | 有効なプラン、料金、またはギフトカード。 | **is:active**    |
| `captured`  | キャプチャ済みの支払い。         | **is:captured**  |
| `disputed`  | 不審請求が申請された支払い。       | **is:disputed**  |
| `paid`      | 支払い済みの支払いまたは請求書。     | **is:paid**      |
| `recurring` | 継続的な料金。              | **is:recurring** |
| `refunded`  | 返金された支払い。            | **is:refunded**  |

### 検索語句の組み合わせおよび否定条件の使用

検索結果を絞り込むには、複数の検索語を使用します。また、検索フィルターでハイフン (`-`) を否定条件として指定し、一致したものが含まれない結果を得ることもできます。

| 例                                 | 説明                                           |
| --------------------------------- | -------------------------------------------- |
| `type:card last4:4242 exp:08/22`  | カードの末尾 4 桁が `4242` であり、有効期限が `08/22` である。    |
| `type:card last4:4242 -exp:08/22` | カードの末尾 4 桁が `4242` であり、有効期限が `08/22` 「ではない」。 |
| `type:ideal status:canceled`      | ソースがキャンセルされ、支払いの実行には使用されていない iDEAL 支払い。      |

句全体を検索するには、引用符を使用します。たとえば **“Stripe Shop”** と指定すると、この句全体と一致する結果が得られますが、**Stripe Shop** では **Stripe** と **Shop** の各語が別々に検索されます。

### メタデータ検索

オブジェクトがサポートしている[メタデータ](https://docs.stripe.com/api.md#metadata)をオブジェクトに追加した場合、そのメタデータを検索できます。たとえば、以下のいずれかの検索クエリを使用して、メタデータキー `order_id` が設定され、対応するメタデータ値 `xyn712` が指定されたドキュメントを見つけることができます。

- `xyn712`
- `order_id:xyn712`
- `metadata:xyn712`
- `metadata:order_id=xyn712`

## 組織全体の検索

複数の Stripe アカウントを[組織](https://docs.stripe.com/get-started/account/orgs.md)に追加した後、チームメンバーは、その組織でアクセスできるすべてのアカウントを検索できます。デフォルトでは、該当するすべてのアカウントが検索結果に表示されます。チームメンバーがアカウント内からダッシュボードを表示している場合、検索ドロップダウンにそのアカウント内のみを検索するオプションが表示されます。

## ベストプラクティス

多くの場合、検索は 1 つの検索語で実行できます。名前やメールアドレスなど、個別性の高い語句を使用します。結果件数が少なすぎる場合は、より概括的な検索語を指定します。結果件数が多すぎる場合は、別の用語を一度に 1 つずつ追加します。

日付や金額を検索語句として使用する場合は、広めの値範囲の値を指定します。支払いに関する情報を検索する場合、お客様と顧客との間の通貨の換算とタイムゾーンの違いによって混乱が生じる場合があります。そのような場合には、追加の検索語句を使用するか、別の検索語句もまとめて使用します。

> #### ブックマーク検索
> 
> 検索語句は URL に含まれるので、他のウェブページの場合と同様、検索にブックマークを付けたりチームメンバーと共有することができます。