调用Media.ListCustomerMediaItems接口响应缺失mediaItems字段咨询

该异常不属于接口本身的通用故障，均为调用配置问题导致，按以下优先级排查即可定位原因：

• 分页参数不合法
  该接口默认单页返回条数由pageSize参数控制，合法取值范围为1-100。如果传入0、大于100的数值、非整数类型的pageSize，接口不会抛出参数错误，会直接返回totalMediaItemCount、nextPageToken字段，但省略mediaItems字段或返回空数组。另外部分版本接口存在分页逻辑异常：第一页请求会返回空mediaItems，所有数据被放到后续分页中，拿到nextPageToken后持续翻页直到token为空即可拿到全量数据。
• 读取权限不足
  若调用身份仅持有商家账号的基础信息查看权限、无客户媒体资源的读取权限，接口不会返回403权限错误，会隐式拦截具体媒体内容，仅返回总计数和分页令牌。可直接使用店铺所有者身份的有效密钥发起相同请求，若能正常返回mediaItems数组，即可判定为权限配置缺失。
• 返回字段掩码配置错误
  调用时如果传入了readMask参数指定返回字段，但未将mediaItems加入掩码列表，接口仅会返回掩码内声明的字段，以及通用统计字段totalMediaItemCount、分页字段nextPageToken，不会返回未声明的mediaItems内容。
• 媒体内容被默认规则过滤
  totalMediaItemCount的计数逻辑包含待审核、被举报下架、隐私受限的不可公开访问媒体项，但接口默认会过滤这部分内容不返回。如果30条媒体项全部处于受限状态，就会出现计数不为0但无返回内容的情况，此时传入showFiltered=true参数即可拿到被过滤的媒体项。

排查顺序建议：先校验pageSize取值合法性 → 核对readMask字段配置 → 换高权限身份测试 → 最后加showFiltered参数验证过滤逻辑。

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