【问题标题】：Adding Meta Data Columns To Stripe Data Report from `report_runs` API从 `report_runs` API 添加元数据列到条带化数据报告
【发布时间】：2022-12-06 18:51:19
【问题描述】：

简短的介绍

我正在尝试使我们从 Stripe WebUI 手动生成的报告自动化。我可以抓取大部分感兴趣的列，但我无法弄清楚如何抓取我们可以从 WebUI 获得的所有潜在列。

成功示例请求

curl https://api.stripe.com/v1/reporting/report_runs \
  -u $STRIPE_TEST_API_KEY \
  -d report_type="exports.unified_payments" \
  -d "parameters[columns][]"="id" \
  -d "parameters[columns][]"="Description" \
  -d "parameters[columns][]"="Seller Message" \
  -d "parameters[columns][]"="Created (UTC)" \
  -d "parameters[columns][]"="Amount" \
  -d "parameters[columns][]"="Amount Refunded" \
  -d "parameters[columns][]"="Currency" \
  -d "parameters[columns][]"="Converted Amount" \
  -d "parameters[columns][]"="Converted Amount Refunded" \
  -d "parameters[columns][]"="Fee" \
  -d "parameters[columns][]"="Tax" \
  -d "parameters[columns][]"="Converted Currency" \
  -d "parameters[columns][]"="Status" \
  -d "parameters[columns][]"="Statement Descriptor" \
  -d "parameters[columns][]"="Customer ID" \
  -d "parameters[columns][]"="Customer Description" \
  -d "parameters[columns][]"="Customer Email" \
  -d "parameters[columns][]"="Captured" \
  -d "parameters[columns][]"="Card ID" \
  -d "parameters[columns][]"="Invoice ID" \
  -d "parameters[columns][]"="Transfer" \

我要添加的列

payment_metadata[Admin URL] 
 payment_metadata[Buyer ID] 
 payment_metadata[Discounts] 
 payment_metadata[Item Total] 
 payment_metadata[Order Number] 
 payment_metadata[Payment ID] 
 payment_metadata[Request ID] 
 payment_metadata[Shipping] 
 payment_metadata[Shipping Class] 
 payment_metadata[Store ID] 
 payment_metadata[Storenvy ID] 
 payment_metadata[Tax] 
 payment_metadata[require_zip_check] 
 payment_metadata[requires_zip_check]

没有这方面的文档吗？

如果您输入的名称不正确，您会收到 this documentation endpoint 的回复，这很搞笑 404。这意味着我目前正在玩猜测和检查游戏。我希望互联网上的某个人比我更了解这个话题。

我试过的列名语法

% curl https://api.stripe.com/v1/reporting/report_runs \
  -u $STRIPE_TEST_API_KEY \
  -d report_type="exports.unified_payments" \
  -d "parameters[columns][]"="Order Number (metadata)"
{
  "error": {
    "message": "The value for `parameters.columns` contains invalid column identifiers: \"Order Number (metadata)\". For the list of valid columns for exports.unified_payments, see https://stripe.com/docs/reporting/statements/report-types#schema-exports-unified-payments.",
    "request_log_url": "https://dashboard.stripe.com/test/logs/req_wcjrHaKjFjbT7t?t=1670317430",
    "type": "invalid_request_error"
  }
}
% curl https://api.stripe.com/v1/reporting/report_runs \
  -u $STRIPE_TEST_API_KEY \
  -d report_type="exports.unified_payments" \
  -d "parameters[columns][]"="Order Number"
{
  "error": {
    "message": "The value for `parameters.columns` contains invalid column identifiers: \"Order Number\". For the list of valid columns for exports.unified_payments, see https://stripe.com/docs/reporting/statements/report-types#schema-exports-unified-payments.",
    "request_log_url": "https://dashboard.stripe.com/test/logs/req_ocr6WwyUMWSsoA?t=1670317446",
    "type": "invalid_request_error"
  }
}
% curl https://api.stripe.com/v1/reporting/report_runs \
  -u $STRIPE_TEST_API_KEY \
  -d report_type="exports.unified_payments" \
  -d "parameters[columns][]"="payment_metadata[Order Number]"
{
  "error": {
    "message": "The value for `parameters.columns` contains invalid column identifiers: \"payment_metadata[Order Number]\". For the list of valid columns for exports.unified_payments, see https://stripe.com/docs/reporting/statements/report-types#schema-exports-unified-payments.",
    "request_log_url": "https://dashboard.stripe.com/test/logs/req_fbKu58dqgAweLw?t=1670317597",
    "type": "invalid_request_error"
  }
}
% curl https://api.stripe.com/v1/reporting/report_runs \
  -u $STRIPE_TEST_API_KEY \
  -d report_type="exports.unified_payments" \
  -d "parameters[columns][]"="Payment Metadata[Order Number]"
{
  "error": {
    "message": "The value for `parameters.columns` contains invalid column identifiers: \"Payment Metadata[Order Number]\". For the list of valid columns for exports.unified_payments, see https://stripe.com/docs/reporting/statements/report-types#schema-exports-unified-payments.",
    "request_log_url": "https://dashboard.stripe.com/test/logs/req_r8fVXjcgwwipRv?t=1670317908",
    "type": "invalid_request_error"
  }
}

【问题讨论】：

标签： curl stripe-payments

【解决方案1】：

正确的语法是-d "parameters[columns][]"="payment_metadata[Order Number]"

但是您会收到错误消息，因为该类型的报告 (exports.unified_payments) 不支持该列。只有确定逐条列出报告（例如balance_change_from_activity.itemized.2 或balance_change_from_activity.itemized.3）支持这些列；请参阅https://stripe.com/docs/reports/report-types 上的列定义

【讨论】：