从 API 检索 Stripe 发票时，如何扩展对象以检索信用卡详细信息和其他信息

Question

我有一个 Google Apps 脚本，它访问 Stripe API，从 Stripe 发票参考中检索数据并将数据添加到 Google 表格中。

Stripe 提到我可以扩展对象以获取扩展对象引用的更多信息。但是我对使用 API 相当陌生，所以我不确定如何做到这一点。

我认为我被卡住的原因是因为我从 URL(即 https://api.stripe.com/v1/invoices/xxxxxxxxxxxxxxxxxxxxxxxxxx(中提取发票数据。我不确定如何修改 URL 以展开对象(或者我应该在下面的代码中在哪里执行此操作(。

例如，我想扩展"收费"对象以包含有关付款的更多详细信息。我想从收费对象中获取的数据是卡类型(例如：Visa(、到期日、最后四位数字。我可能会对 Customer 对象执行相同的操作，以访问有关发票的客户详细信息。

这是我现在使用的Google Apps脚本：

function onOpen() {
  var ui = SpreadsheetApp.getUi();
  ui.createMenu('Stripe')
    .addItem('Retrieve Invoice Data','getInvoiceObj')
    .addToUi();
}
function getInvoiceObj() 
  {
    var apiKey, content, options, response, secret, url;
    //API Key
    secret = "rk_live_xxxxxxxxxxxxxxxxxxxxxxxxxx";
    apiKey = "xxxxxxxxxxxxxxxxxxxxxxxxxx";
    //Stripe API invoice URL 
    url = "https://api.stripe.com/v1/invoices/xxxxxxxxxxxxxxxxxxxxxxxxxx";

    options = {
      "method" : "GET",
      "headers": {
        "Authorization": "Bearer " + secret 
      },
      "muteHttpExceptions":true
    };
    response = UrlFetchApp.fetch(url, options);
    //Push data to Sheet from invoice. **Writes over existing Sheet data**
    content = JSON.parse(response.getContentText());
    var sheet = SpreadsheetApp.getActiveSheet();
    //Retrieves currency type and adds to Sheet
    sheet.getRange(5,2).setValue([content.currency.toUpperCase()]);
    //Invoice amount due
    sheet.getRange(3,2).setValue([content.amount_due]);
    //Invoice date
    sheet.getRange(1,2).setValue([content.date]);
    //Invoice period begin
    sheet.getRange(6,2).setValue([content.lines.data[0].period.start]);
    //Invoice period end
    sheet.getRange(7,2).setValue([content.lines.data[0].period.end]);
    //Number of licenses
    sheet.getRange(10,2).setValue([content.lines.data[0].quantity]);
    //Invoice number
    sheet.getRange(13,2).setValue([content.number]);

Answer 1

这里有两个选项：

1. 当您提取发票时，Stripe API 会返回一个发票对象 1，该对象 1 又有一个包含费用 ID 的charge字段。然后，您可以单独致电v1/charges/{charge_id_goes_here}以获取费用详细信息。

2. 在获取发票时展开charge。我不熟悉UrlFetchApp，但您必须在请求中指定您希望扩展charge对象。您将发送一个 GET 请求，其中包含要使用类型 application/x-www-form-urlencoded 展开的对象。看看它在cURL中是如何完成的，这可能会帮助你：https://stripe.com/docs/api/expanding_objects?lang=curl

另外，如果可以的话，我建议使用官方的 stripe-node 库，这将使与 Stripe API 的交互变得更加容易。