从Google Checkout的订单报告API中检索扩展的CSV数据

Google Checkout订单报告API检索扩展CSV数据指南

基础概念

Google Checkout订单报告API是Google提供的一种接口，允许开发者以编程方式检索订单数据。扩展CSV格式提供了比标准CSV更详细的订单信息，包括交易详情、买家信息、配送数据等。

主要类型

Google Checkout API提供多种报告类型：

订单报告
财务报告
风险报告
退款报告

应用场景

订单管理系统集成
财务对账
库存管理
客户行为分析
欺诈检测

常见问题及解决方案

问题1：API认证失败

原因：通常是由于无效的商户ID和密钥解决：

import base64
import requests

merchant_id = "YOUR_MERCHANT_ID"
merchant_key = "YOUR_MERCHANT_KEY"
auth_string = base64.b64encode(f"{merchant_id}:{merchant_key}".encode()).decode()

headers = {
    "Authorization": f"Basic {auth_string}",
    "Content-Type": "application/xml; charset=UTF-8"
}

问题2：获取扩展CSV数据时返回空结果

原因：可能未正确设置时间范围或订单状态解决：

import datetime

today = datetime.datetime.now()
start_date = (today - datetime.timedelta(days=7)).strftime("%Y-%m-%dT%H:%M:%S.000Z")
end_date = today.strftime("%Y-%m-%dT%H:%M:%S.000Z")

params = {
    "start-date": start_date,
    "end-date": end_date,
    "status": "FINISHED",  # 可以是NEW, PROCESSING, FINISHED等
    "format": "CSV",
    "extended": "true"
}

问题3：CSV数据解析错误

原因：扩展CSV包含多行记录和复杂结构解决：

import csv
from io import StringIO

# 假设response.text包含API返回的CSV数据
csv_data = StringIO(response.text)
reader = csv.DictReader(csv_data)

for row in reader:
    # 处理每行数据
    print(row["order-number"], row["buyer-name"], row["total-amount"])

问题4：大文件下载超时

原因：报告数据量过大导致请求超时解决：

import requests

# 使用流式下载
response = requests.get(api_url, headers=headers, params=params, stream=True)

with open("order_report.csv", "wb") as f:
    for chunk in response.iter_content(chunk_size=8192):
        if chunk:
            f.write(chunk)