预发布公告：扩展邮件安全报告API变更

日期：2025年10月9日

我们将很快为按月订阅的企业用户推出新插件，支持购买和使用 扩展邮件安全 产品。该产品通过检测并拦截垃圾邮件、钓鱼攻击、恶意软件及其他有害内容，在邮件到达邮箱前过滤和保护进出邮件流量，从而保障更安全的邮件通信。

为配合此次变更，我们提前通知您关于API方法的计划更新，以便您对自动化工具或集成进行必要调整。新增属性 extendedEmailSecurityMonthlyUsage 将被添加到现有方法 getMonthlyUsage 和 getMonthlyUsagePerProductType 的返回结果中，用于追踪该新插件的月度使用量：

getMonthlyUsage

{
  "result": {
    "endpointMonthlyUsage": 4,
    "encryptionMonthlyUsage": 0,
    "emailSecurityMonthlyUsage": 0,"extendedEmailSecurityMonthlyUsage": 0"mobileSecurityMonthlyUsage": 0,
    "exchangeMonthlyUsage": 0,
    "atsMonthlyUsage": 0,
    "edrMonthlyUsage": 0,
    "edrStorage90DaysUsage": 0,
    "edrStorage180DaysUsage": 0,
    "edrStorage1YearUsage": 0,
    "mdrFoundationsMonthlyUsage": 0,
    "patchManagementMonthlyUsage": 0,
    "integrityMonitoringUsage": 0,
    "integrityMonitoring90DaysUsage": 0,
    "integrityMonitoring180DaysUsage": 0,
    "integrityMonitoring1YearUsage": 0,
    "sveVsMonthlyUsage": 0,
    "sveVdiMonthlyUsage": 0,
    "containerProtectionMonthlyUsage": 0,
    "xdrIdentitySensorsMonthlyUsage": 0,
    "xdrProductivitySensorsMonthlyUsage": 0,
    "xdrNetworkSensorsMonthlyUsage": 0,
    "xdrCloudSensorsMonthlyUsage": 0,
    "phasrMonthlyUsage": 0,
    "easmMonthlyUsage": 0,
    "complianceMonthlyUsage": 2,
    "aLaCarteMonthlyUsage": 1,
    "mspSecureMonthlyUsage": 1,
    "mspSecurePlusMonthlyUsage": 0,
    "mspSecureExtraMonthlyUsage": 2
  },
  "jsonrpc": "2.0",
  "id": "5986",
  "error": null
}

getMonthlyUsagePerProductType

{
  "result": {
    "usages": [
      {
        "endpointMonthlyUsage": 3,
        "encryptionMonthlyUsage": 0,
        "atsMonthlyUsage": 0,
        "edrMonthlyUsage": 0,
        "edrStorage90DaysUsage": 0,
        "edrStorage180DaysUsage": 0,
        "edrStorage1YearUsage": 0,
        "mdrFoundationsMonthlyUsage": 0,
        "patchManagementMonthlyUsage": 0,
        "integrityMonitoringUsage": 0,
        "integrityMonitoring90DaysUsage": 0,
        "integrityMonitoring180DaysUsage": 0,
        "integrityMonitoring1YearUsage": 0,
        "sveVsMonthlyUsage": 0,
        "sveVdiMonthlyUsage": 0,
        "emailSecurityMonthlyUsage": 0,"extendedEmailSecurityMonthlyUsage": 0,"mobileSecurityMonthlyUsage": 0,
        "exchangeMonthlyUsage": 0,
        "containerProtectionMonthlyUsage": 0,
        "xdrIdentitySensorsMonthlyUsage": 0,
        "xdrProductivitySensorsMonthlyUsage": 0,
        "xdrNetworkSensorsMonthlyUsage": 0,
        "xdrCloudSensorsMonthlyUsage": 0,
        "phasrMonthlyUsage": 3,
        "easmMonthlyUsage": 2,
        "complianceMonthlyUsage": 2,
        "productType": 0,
        "aLaCarteMonthlyUsage": 0,
        "mspSecureMonthlyUsage": 3,
        "mspSecurePlusMonthlyUsage": 0,
        "mspSecureExtraMonthlyUsage": 0
      },
      {
        "endpointMonthlyUsage": 0,
        "mdrFoundationsMonthlyUsage": 0,
        "productType": 3
      }
    ]
  },
  "jsonrpc": "2.0",
  "id": "2821",
  "error": null
}

{
  "params": {
    "targetMonth": "11/2025",
    "companyId": "55115935b1a43dcc4a7b23c6"
  },
  "jsonrpc": "2.0",
  "method": "getExtendedEmailSecurityFilteredUsage",
  "id": "5087eab8-b74f-4a3e-85b3-4271e85890d4"
}

{
  "result": {
    "extendedEmailSecurityMonthlyUsage": 2387
  },
  "jsonrpc": "2.0",
  "id": "5087eab8-b74f-4a3e-85b3-4271e85890d4"
}