后端【免费下载链接】google-api-nodejs-clientGoogles officially supported Node.js client library for accessing Google APIs. Support for authorization and authentication with OAuth 2.0, API Keys and JWT (Service Tokens) is included.项目地址https://gitcode.com/gh_mirrors/go/google-api-nodejs-client点击查看免费下载src/apis/merchantapi/CHANGELOG.md记录了 Google Merchant Center API 的 Node.js 客户端子包googleapis/merchantapi自 2024 年 7 月发布 0.1.0 以来两年间的完整版本历史。这份文档不仅是发布流水账更承载着关键的破坏性变更Node 运行时版本提升、googleapis-common依赖升级、服务端 API 结构调整与维护策略信息。本文以该 CHANGELOG 为主体结合仓库中 package.json、index.ts 与各版本 TypeScript 源码帮你快速定位每次升级的风险点、确认当前运行环境是否满足要求并读懂 Google 官方对 merchantapi 子包维护模式的定位。一、版本脉络总览两年 40 次发布的节奏与规律对照 CHANGELOG 可梳理出googleapis/merchantapi的完整发布轨迹时间按发行顺序排列版本发布日期变更类型核心内容0.1.02024-07-26Bug Fix首个可用版本API 初版更新1.0.02024-08-16BREAKING正式 1.0API 更新1.1.02024-08-27FeatureAPI 更新2.0.02024-10-30BREAKINGAPI 更新 修复3.0.02025-02-04BREAKINGAPI 更新4.0.02025-03-18BREAKINGAPI 更新4.1.02025-03-19FeatureAPI 更新5.0.02025-05-05BREAKINGAPI 更新f04cb22 修复6.0.02025-05-29BREAKINGNode 运行时提升至 186.0.12025-06-04Bug Fixgoogleapis-common升级至 8.0.2-rc7.0.02025-06-30BREAKINGNode 18 落地 API 更新 依赖升级8.0.02025-07-08BREAKINGAPI 更新4c1b697、1cae8169.0.02025-07-15BREAKINGAPI 更新b42712e10.0.02025-07-22BREAKING生成器重跑#371610.1.02025-07-25Feature生成器重跑#372111.0.02025-08-04BREAKINGAPI 更新daa4e021.0.02025-08-07BREAKING独立包 1.0 基线生成器 #3716/#37212.0.02025-08-13BREAKINGAPI 更新3.0.02025-08-21BREAKINGAPI 更新4.0.02025-08-25BREAKINGAPI 更新5.0.02025-08-26BREAKINGAPI 更新6.0.02025-08-27BREAKINGAPI 更新7.0.02025-08-28BREAKINGAPI 更新8.0.02025-08-29BREAKINGgoogleapis-common升级至 8.0.0 API 更新12.0.02025-09-16BREAKING统一发布 googleapis-common8.0.0升级13.0.02025-09-30BREAKING生成器重跑#379513.1.02025-10-09FeatureAPI 更新14.0.02025-10-15BREAKING生成器重跑#381415.0.02025-11-04BREAKINGAPI 更新16.0.02025-11-11BREAKING生成器重跑#383116.1.02025-11-26FeatureAPI 更新 重建 index17.0.02025-12-05BREAKINGAPI 更新17.1.02025-12-15Feature/Bug Fix重建 index API 更新17.2.02026-01-09Feature生成器重跑#386117.3.02026-01-28FeatureAPI 更新17.4.02026-05-19FeatureAPI 更新18.0.02026-05-28BREAKING生成器重跑#392019.0.02026-08-03BREAKING生成器重跑#395520.0.02026-08-14BREAKINGAPI 更新20.0.12026-08-28Bug FixAPI 更新21.0.02026-08-31BREAKINGAPI 更新21.1.02026-09-02Feature/Bug Fix生成器#3992 依赖升级至 Node 2221.1.12026-09-09Bug Fix临时恢复 Node 18 支持22.0.02026-09-09BREAKINGNode 22 最低版本#4011 生成器23.0.02026-09-10BREAKINGNode 22 最低版本#401124.0.02026-09-10BREAKINGNode 22 最低版本#4011 API 更新25.0.02026-09-14BREAKING再次要求 Node 22 最低版本#4020全包统一25.1.02026-09-23FeatureAPI 更新25.2.02026-10-03FeatureAPI 更新25.2.12026-10-14Bug FixAPI 更新两个值得注意的现象CHANGELOG 内版本顺序并非严格按发布时间排列。例如 12.0.02025-09-16在文件里位于 8.0.02025-08-29之前而 11.0.02025-08-04又排在 1.0.02025-08-07之后。这是 release-please 自动生成 CHANGELOG 时的分组/排序行为阅读时建议以发布日期列为准。破坏性变更集中在两个维度服务端 API 定义变化表现为update the API并触发 BREAKING 标记与运行时/依赖约束变化Node 版本、googleapis-common版本。二、破坏性变更深度解读Node 版本门槛的两次跃迁这是 CHANGELOG 中最值得升级前关注的部分因为它是环境级约束直接影响 CI 与部署流水线。2.1 第一次跃迁Node 182025 年 5 月6.0.02025-05-29首次标记upgrade to node 18并在 7.0.02025-06-30以682fbb8落地。这意味着 Node 16 及以下环境在升级到 6.0.0 时即被官方排除。2.2 第二次跃迁Node 222026 年 9 月21.1.0 先做了依赖侧准备upgrade dependencies in generated packages to Node 22随后 21.1.1 一度add back support for node 18作为临时回退。22.0.0 / 23.0.0 / 24.0.02026-09-0910正式将最低版本提升至 Node 22对应 issue #4011。25.0.02026-09-14再次重申Update apiary to minimum Node version of 22 again - all packages#4020说明这是一次覆盖所有子包的统一行动而不是 merchantapi 单个包的独立决定。2.3 如何核对当前环境的 Node 版本要求升级到 25.x 后可直接查看 src/apis/merchantapi/package.json 中的声明{ name: googleapis/merchantapi, version: 25.2.1, engines: { node: 22.0.0 } }仓库当前状态与 CHANGELOG 顶部版本25.2.1完全一致engines.node为22.0.0。升级前提本机或容器镜像中的 Node 主版本必须 ≥ 22否则应在升级前先完成 Node 运行时迁移。三、依赖链演进googleapis-common 的三次升级merchantapi 的所有生成代码都构建在googleapis-common之上createAPIRequest、AuthPlus、GoogleConfigurable等均来自该包。CHANGELOG 记录了它的三次关键变动版本依赖状态对应 CHANGELOG 条目6.0.1 / 7.0.0升级至googleapis-common8.0.2-rcf4b09902025-06-04 / 2025-06-308.0.0 / 12.0.0升级至googleapis-common8.0.0#3731c9fdf4b2025-08-29 / 2025-09-1621.1.0 起生成包依赖升级至 Node 22 配套版本2026-09-02当前仓库 src/apis/merchantapi/package.json 中依赖声明为googleapis-common: ^9.0.0说明在 CHANGELOG 记录的 8.0.x 之后官方又推进到了 9.x 大版本。由于这是共享底层库升级 merchantapi 时若同时升级 googleapis-common应整体回归验证认证客户端OAuth2/JWT/Compute初始化、请求拦截器与错误处理行为都可能受其影响。四、从 CHANGELOG 反推发布机制生成器驱动的自动化流水线CHANGELOG 中大量条目标注为run the generator#3716、#3721、#3769、#3795、#3814、#3831、#3861、#3920、#3955、#3992或regenerate index files。从源码结构可以还原这套机制的产物Discovery 文档仓库 discovery 目录存放了 26 份 merchantapi 的 JSON 描述文件如 merchantapi-accounts_v1.json、merchantapi-products_v1.json、merchantapi-reports_v1.json每个文件对应一个 API 版本生成代码src/apis/merchantapi 下的accounts_v1.ts、products_v1.ts等 26 个 TypeScript 文件由生成器产出文件头明确标注THIS FILE IS AUTO-GENERATEDrun the generator 即指重新拉取 Discovery 文档并重跑生成索引文件index.ts 中的VERSIONS对象将 26 个版本逐一注册merchantapi()工厂函数通过getAPI(merchantapi, versionOrOptions, VERSIONS, this)按版本号返回对应的Merchantapi类实例同时导出AuthPlus与全部 26 个版本命名空间发布配置release-please-config.json 中src/apis/merchantapi: {}表明该目录是一个独立的 release-please 发布单元这就是 CHANGELOG 中独立版本号 独立 compare 链接的来源。因此当 CHANGELOG 出现**merchantapi:** update the API时实质是上游 Merchant API 的 Discovery 文档发生变更后生成的代码被同步更新。这类变更虽然多数是新增字段/方法但 Google 服务端也可能重命名参数或调整响应结构因此被标记为 BREAKING—— 升级后建议对涉及的具体 API 调用做一次契约级回归例如用createAPIRequest响应中的 Schema 类型做编译期校验。五、典型方法级佐证以 products_v1 为例要验证某次update the API具体带来了什么可直接阅读对应版本的生成源码。以 products_v1.ts 为例accounts.products.list的请求 URL 为{rootUrl}/products/v1/{parent}/products方法为 GETrequiredParams: [parent]pageSize最大值为 1000、未指定时默认返回 25 条分页通过pageToken延续Schema$ProductInput展示了产品标识符的编码规则资源名格式为accounts/{account}/productInputs/{productinput}其中{productinput}段的推荐格式是content_language~feed_label~offer_id的unpadded base64url 编码例如ZW5-VVN-c2t1LzEyMw若offer_id包含/、%、~等特殊字符则必须使用编码格式每次请求的根地址由options.rootUrl || https://merchantapi.googleapis.com/决定最终经createAPIRequest执行。同样accounts_v1.ts 中accounts.createAndConfigure的 JSDoc 示例展示了标准调用范式先通过google.auth.GoogleAuth获取https://www.googleapis.com/auth/content权限的 auth client再用google.options({auth: authClient})全局绑定后调用。这些示例中的 scopes 与请求体结构若在升级后发生变化通常就会以 BREAKING 条目出现在 CHANGELOG 中。六、升级实操指南6.1 确认当前版本$ npm ls googleapis/merchantapi或读取 package.json 中version字段当前为 25.2.1。6.2 升级到最新版$ npm install googleapis/merchantapilatest6.3 升级前检查清单Node 版本运行node -v确认 ≥ 22对应 25.x 的engines要求googleapis-common确认与googleapis/merchantapi25.x的^9.0.0依赖约束兼容必要时一并升级认证方式项目若使用google.auth.GoogleAuth或AuthPlus见 index.ts 的导出升级底层依赖后重新验证凭据加载路径API 契约回归对accounts、products、reports、promotions、inventories等高频资源做一次真实调用比对请求/响应结构浏览 CHANGELOG 原文逐条阅读 src/apis/merchantapi/CHANGELOG.md 中最近 23 个大版本当前即 23.0.0 → 25.2.1 区间的 BREAKING 标记确认无遗漏风险。6.4 按需选择 API 版本通过 index.ts 可知该子包同时提供 26 个版本accounts_v1、accounts_v1beta、conversions_v1、conversions_v1beta、datasources_v1、datasources_v1beta、inventories_v1、inventories_v1beta、issueresolution_v1、issueresolution_v1beta、lfp_v1、lfp_v1beta、loyaltycustomers_v1、notifications_v1、notifications_v1beta、ordertracking_v1、ordertracking_v1beta、products_v1、products_v1beta、promotions_v1、promotions_v1beta、quota_v1、quota_v1beta、reports_v1、reports_v1beta、reviews_v1beta均可用google.merchantapi(版本名)或merchantapi({version})方式获取实例const {google} require(googleapis); const merchantapi google.merchantapi(products_v1); const res await merchantapi.accounts.products.list({ parent: accounts/123, pageSize: 100, });七、维护模式声明新项目请考虑替代库CHANGELOG 之外src/apis/merchantapi/README.md 明确声明本库googleapis/merchantapi处于维护模式maintenance mode会继续供已有应用使用但新项目或现代化改造中的存量项目Google 官方建议改用google-shopping/accounts库理由是后者更快、更易用、维护更积极。安装命令为$ npm install googleapis/merchantapi # 现有维护模式库 # 或面向新项目 $ npm install google-shopping/accounts # 官方推荐替代库决策建议若项目已在生产环境稳定运行且不希望引入迁移成本可继续锁定googleapis/merchantapi并按上文清单随版本升级若正在新建服务或重构优先评估迁移到官方推荐库。八、总结googleapis/merchantapi的 CHANGELOG 完整记录了该子包从 0.1.02024-07到 25.2.12026-10的演进史其核心风险信号集中在三处Node 运行时门槛18 → 22、googleapis-common 底层依赖升级8.0.x → 9.0.0以及由 Discovery 文档驱动的 API 契约变更大量 BREAKING 标记。结合仓库内的 package.json、index.ts、26 份生成源码与 discovery 目录中的 26 份 API 描述开发者可以在升级前完成环境核验、契约回归与版本选择将破坏性变更对线上服务的影响降到最低。赞分享后端【免费下载链接】google-api-nodejs-clientGoogles officially supported Node.js client library for accessing Google APIs. Support for authorization and authentication with OAuth 2.0, API Keys and JWT (Service Tokens) is included.项目地址https://gitcode.com/gh_mirrors/go/google-api-nodejs-client点击查看免费下载相关推荐vue-chartjs 版本演进全解析从 CHANGELOG 读懂 API 变迁、破坏性变更与迁移路径vue chartjs 版本演进全解析从 CHANGELOG 读懂 API 变迁、破坏性变更与迁移路径 导读 本文以仓库 CHANGELOG.md http前端数据可视化UI组件读懂 googleapis/adexchangebuyer 的 CHANGELOG版本演进、破坏性变更与自动发布机制解析读懂 googleapis/adexchangebuyer 的 CHANGELOG版本演进、破坏性变更与自动发布机制解析 本文以 src/apis/adex后端JupyterHub Changelog 深度解读从 0.1 到 6.0 的版本演进、破坏性变更与升级路径JupyterHub Changelog 深度解读从 0.1 到 6.0 的版本演进、破坏性变更与升级路径 本篇技术指南以 JupyterHub 官方 cha后端微服务上一篇Qclaw Dashboard 实操手册网关状态实时监控、一键重启与自动修复详解下一篇如何在Mac上制作Linux启动U盘macUSB 19大发行版支持、dd裸写与SHA-256校验全解析创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考