电子表格导出

1. 选择哪一种

两者完成同一任务，区别在于公司已使用哪个账户体系。

	Google Sheets	Microsoft SharePoint
写入形式	附加到工作表的一行	列表中的一项
需要提供	服务账户密钥、电子表格 ID	租户、客户端 ID、客户端密钥、站点 ID、列表 ID
列	固定顺序，共八列	列表中有哪些就用哪些，先查询
配置工作	创建服务账户，将表格分享给它	注册应用，仅授予一个站点的权限

2. Google Sheets：大家常忘记的分享步骤

服务账户是独立用户，其电子邮箱地址以 .iam.gserviceaccount.com结尾。仅创建密钥不够， 必须将电子表格分享给该地址，就像分享给同事一样。

跳过此步，每次写入都会返回 403。我们会在错误消息中明确指出，因为 Google 自己的措辞没有提及，导致人们花整个下午排查密钥。

如果更方便，可粘贴完整 URL

电子表格 ID 位于 /d/ 与 /edit之间。可将整个地址粘贴到字段中，我们会提取所需部分。

刻意按原始值写入

不按“用户输入”解释。否则，Google 会将类似 00123 的客户 ID 视为数字，去掉前导零；以 = 开头的值则会变成公式。

3. SharePoint：先读列，再写入

如果写入项指定了列表中不存在的列，SharePoint 会拒绝；内部列名又取决于创建列表时的选择。假设存在固定列集，每遇到两个客户就可能有一个失败。

因此，我们每小时获取一次列表列信息，仅写入已存在且非只读的列。如果列表只有默认的 Title 列，就只写入目标名称，而非每个目标都失败。

如自行创建，可使用以下可选列： MPSession、 MPChannel、 MPUser、 MPValue、 MPCurrency、 MPUrl、 MPTime。

Microsoft 推荐的权限并非您所需

对于此调用，Microsoft 文档将 Sites.ReadWrite.All 列为最小权限。可这为一个只填充单个列表的集成，授予了 租户中每个站点的写入权限。

请改用 Sites.Selected ：具备此权限的应用默认完全没有访问权，管理员再向其授予恰好一个站点的写入权限。 同时授予两者会抵消限制 ，只有应用没有其他权限时，较窄的权限才有效。

4. 行中包含什么

时间戳、项目、会话、客户 ID、目标名称、价值、货币，以及回放录制的链接。在 SharePoint 中，同样的值会写入实际存在的相应列，并采用列类型要求的形式：超链接列接收链接对象，文本列接收同一地址的文本。

空单元格表示“未约定金额”，而非零

没有金额的目标会将单元格留空。零会在电子表格中汇总成一个从未存在的总额。

客户 ID 在投递时查询

而非目标触发时。通常在登录时识别身份，也就是说，经常在目标 之后 。晚几秒查询，对事件管道开销更小，也更容易找到姓名。