如何在 JavaScript 中一次性发送多个数据对象到 API-js教程-PHP中文网

如何在 JavaScript 中一次性发送多个数据对象到 API

本文详解在 google apps script 中通过 urlfetchapp 向外部 api 同时提交两个或多个结构化数据对象（如 payload 和 payload1）的两种可靠方案：合并为数组批量发送，或分次独立发送，并附完整可运行代码与关键注意事项。

本文详解在 google apps script 中通过 urlfetchapp 向外部 api 同时提交两个或多个结构化数据对象（如 payload 和 payload1）的两种可靠方案：合并为数组批量发送，或分次独立发送，并附完整可运行代码与关键注意事项。

在使用 Google Apps Script 调用外部 REST API（例如 Roistat）时，常需将表格中多列数据按不同指标分别构造成独立的有效载荷（payload）。如示例中，payload 对应指标 ID 2（如“注册数”），payload1 对应指标 ID 3（如“付费金额”），二者共享 source（B 列）和 period（E 列），但数值来源不同（C 列 vs D 列）。此时，不能简单拼接字符串或重复调用 fetch() 而不处理响应逻辑——必须明确选择「单请求多对象」还是「多请求单对象」策略，并确保服务端能正确解析。

✅ 方案一：单次请求发送数组（推荐用于支持批量接口的场景）

若目标 API 接受 JSON 数组作为请求体（例如 /api/v1/metrics/batch），最高效的方式是将所有 payload 对象收集到一个数组中，再整体序列化发送：

function sendDataToRoistatAPI() {
  var url = "https://XXX"; // 注意：原文中 https:/XXX 缺少一个 '/'，已修正
  var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = spreadsheet.getSheetByName("Users");
  var data = sheet.getDataRange().getValues();

  var combinedPayloads = [];

  // 从第 1 行开始（跳过表头），逐行构建两个 payload 并推入数组
  for (var i = 1; i <blockquote>
<p>⚠️ <strong>注意事项</strong>：  </p>
<ul>
<li>务必确认 API 文档是否接受 <code>POST /endpoint</code> + <code>body: [{...}, {...}]</code> 格式；部分 API 要求顶层键名（如 <code>{ "data": [...] }</code>），此时需调整 <code>JSON.stringify({ data: combinedPayloads })</code>。  </li>
<li>添加 <code>muteHttpExceptions: true</code> 和 <code>try/catch</code> 可防止单条错误阻塞全部发送，并便于定位失败原因。  </li>
<li>使用 <code>Number()</code> 和 <code>toString()</code> 显式类型转换，避免因单元格格式导致数值/字符串异常。</li>
</ul>
</blockquote><h3>✅ 方案二：分次独立请求（兼容性更强，适合不支持批量的 API）</h3><p>若 API 仅设计为单对象接收（如 <code>/api/v1/metric</code>），则需对每个 payload 单独构造请求并调用 <code>UrlFetchApp.fetch()</code>：</p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill5703" title="deep-java-review"><img
														src="https://img.php.cn/upload/skill/000/000/081/179060057413304.jpg" alt="deep-java-review" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/skill5703" title="deep-java-review" class="overflowclass">deep-java-review</a>
													<p class="overflowclass">Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...</p>
												</div>
												<a rel="nofollow" href="/xiazai/skill5703" title="deep-java-review" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div><pre class="brush:php;toolbar:false;">// 在原循环内，替换原有单次发送逻辑：
for (var i = 1; i <blockquote>
<p>? <strong>优势与权衡</strong>：  </p>
<ul>
<li>兼容性高，无需服务端修改；  </li>
<li>错误隔离性强——某一条失败不影响其余发送；  </li>
<li>但网络开销略大（N×2 次请求），且需注意 Google Apps Script 的 <a href="https://www.php.cn/link/9b4dbf111c5f71c61b0e2b1eed9ddb0a" rel="nofollow" target="_blank">每日配额限制</a>（如每分钟最多 20 次 <code>UrlFetchApp.fetch</code>）。</li>
</ul>
</blockquote><h3>✅ 总结建议</h3>