求助：无法通过product_endpoint及Graph API获取product_retailer_id/Content ID

云原生阿岚

2026-8-7

解决Graph API无法获取商品product_retailer_id（Content ID）的问题

针对你遇到的通过product endpoint无法获取目标字段、retailer_id返回null的情况，可以尝试以下排查和解决步骤：

确认字段映射与数据源同步
后台商品目录显示的Content ID（即你要的product_retailer_id），需要确保在商品上传/同步时，该字段已正确映射到Facebook的retailer_id字段。如果是通过CSV或第三方数据源上传，检查数据源中的字段名是否与Facebook商品目录要求的字段匹配——若映射错误，后台显示的Content ID不会同步到API可读取的retailer_id字段中，导致返回null。
切换到Catalog Items端点查询
单独的/{product_id}端点可能存在字段返回限制，尝试使用商品目录的items端点查询：/{catalog_id}/items?fields=id,retailer_id,name。这个端点通常会返回更完整的商品字段集合，包括你需要的retailer_id（Content ID）。
检查API版本与权限
确保使用的Graph API版本是当前稳定版（比如v18.0及以上），旧版本可能存在字段返回逻辑差异。同时确认你的访问令牌已拥有catalog_management权限，且权限范围覆盖目标商品所属的目录。
验证商品状态
若商品处于草稿、审核中或已下架状态，部分字段可能不会被API返回。先在商品目录后台确认商品为已发布且正常生效状态，再重新调用API尝试。
检查商品目录的设置
某些商品目录类型（比如本地库存目录）可能对字段返回有特殊限制，确认目录类型与你的业务场景匹配，且目录设置中未隐藏retailer_id相关字段。