# メタデータを使用したカスタム列の作成

財務諸表にカスタム列を追加する方法をご確認ください。

メタデータを使用して補足情報を保存および送信できます。メタデータは、オブジェクトまたは取引に関連付けられたキーと値のペアで構成されます。メタデータを使用すると、カスタム情報を Stripe データに添付できるため、コア取引データとともに関連する詳細を保存および取得できます。

メタデータを使用して Stripe レポートから特定の情報を絞り込んで取得し、的を絞ったレポートを簡単に作成して正確なデータを抽出できます。

詳しくは、[メタデータ](https://docs.stripe.com/metadata.md)をご覧ください。

## メタデータの使用

メタデータは、さまざまな方法で Stripe 実装の一部として使用できます。考えられるユースケースには、次のようなものがあります。

- 内部 ID を保存して Stripe オブジェクトを独自のシステム内のオブジェクトと照合する
- Stripe が提供する財務データを自社のシステムと照合する
- Stripe オブジェクトにコンテキスト (支払いなど) を追加してトラブルシューティングを支援する
- Sigma での Stripe データのカスタムレポートと高度なクエリ

これらのユースケースについては、[サンプル API コール](https://docs.stripe.com/metadata/use-cases.md)を参照してください。

## 財務諸表でメタデータを選択する

1. 関連するレポートに移動します。これは、[残高](https://docs.stripe.com/reports/balance.md)、[入金の照合](https://docs.stripe.com/reports/payout-reconciliation.md)、または [アクティビティ](https://docs.stripe.com/reports/activity.md)などです。
1. **ダウンロード**をクリックします。
1. **すべての列** を選択します。
1. メタデータが添付されたオブジェクトがある場合は、対応する [メタデータ] セクションに表示されます。

## メタデータを使用できる場所

メタデータは、特に次のようなさまざまなオブジェクトのレポート作成に使用できます。Charge、Refund、Invoice、Payment、PaymentIntent、Transfer、Product、Customer、Subscription、InvoiceItem、Price、TaxTransaction、CreditNote、Contract、および ContractItem。

> 詳しくは、[メタデータの制限](https://docs.stripe.com/metadata.md#data)をご覧ください。

## メタデータの欠落に関するトラブルシューティング

メタデータ量が、ダウンロードで表示できるメタデータキーの上限数である 100 を超えると、メタデータが欠落する可能性があります。エクスポートに含まれるメタデータ列には、対応するオブジェクトに定義された関連性の高い 100 個のキーが含まれています。

特定のキーの使用を停止し、その後新しいキーを導入した場合、新しいキーはエクスポートに組み込まれません。これは、支払いまたはその他のオブジェクトから古いキーのすべてのインスタンスを遡及的に削除した場合でも当てはまります。メタデータ列はエクスポートプロセス中に動的に生成されず、新しいキーが追加されたときに確立されます (最大 100 キー)。

オブジェクトの 100 キーの制限に達しているにもかかわらず、オブジェクトで現在すべてのキーが使用されていない場合は、Stripe サポートまで[お問い合わせください](https://support.stripe.com/)。オブジェクトから未使用のキーを削除するようにリクエストして、必要なフィールドを含むレポートのダウンロードを有効にします。

### 連結アカウントレポートのメタデータアクセス

メタデータ列は、ダッシュボードからエクスポートされる Connect アカウントレポートには含まれません。これは、連結アカウント全体のメタデータキーの総数が 100 キーという上限を超える可能性があるからです。これらのメタデータの詳細にアクセスするには、Stripe [Reporting API](https://docs.stripe.com/reports/api.md) をご利用ください。

## ベストプラクティス

推奨する方法をいくつかご紹介します。

- メタデータ戦略を事前に計画して、100 キーの制限に達しないようにします
- メタデータキーに一貫性のある命名規則を使用する
- 未使用のメタデータキーを定期的に確認してクリーンアップする
- 整理しやすくするために、さまざまなタイプのメタデータにプレフィックス (“customer_”、“order_” など) を使用することを検討してください