如何通过SendGrid API获取所有Single Send Campaign名称列表？

你需要使用GET /v3/marketing/singlesends端点，而非用于消息级统计的/v3/marketing/stats/singlesends。这个端点会返回所有Single Send活动的基础元数据，包括活动名称、ID、状态、创建时间等核心信息。

修正后的Python代码示例 #

import sendgrid
import json
import os

sg = sendgrid.SendGridAPIClient(os.environ.get('SENDGRID_API_KEY'))
# 调用正确的Single Send列表端点
response = sg.client.marketing.singlesends.get()
parsed_json = json.loads(response.body)
print(json.dumps(parsed_json, indent=4))

示例响应（包含活动名称） #

{
  "result": [
    {
      "id": "ss_123456789",
      "name": "夏季新品促销活动",
      "status": "scheduled",
      "send_at": "2025-06-01T09:00:00Z",
      "created_at": "2025-05-20T14:30:00Z",
      "updated_at": "2025-05-22T10:15:00Z"
    },
    {
      "id": "ss_987654321",
      "name": "会员专属福利通知",
      "status": "completed",
      "send_at": "2025-05-15T11:00:00Z",
      "created_at": "2025-05-10T09:45:00Z",
      "updated_at": "2025-05-15T12:00:00Z"
    }
  ],
  "_metadata": {
    "total_count": 2,
    "next": null,
    "previous": null
  }
}

关联统计数据（可选） #

如果需要将活动名称与统计数据结合，可按以下步骤操作：

• 从/v3/marketing/singlesends的响应中提取每个活动的id
• 调用/v3/marketing/stats/singlesends/{id}端点获取对应活动的统计数据
• 以id为关联键，合并活动名称与统计数据

内容的提问来源于stack exchange，提问作者Stevoisiak