Nest设备房间（ID/显示名）在SDM API中无法同步更新问题

排查步骤 #

• 首先排查基础操作和账号问题：打开Nest应用，确认调用API使用的OAuth账号，和修改设备位置的账号为同一个，且该账号对对应家庭组有管理员权限；重新进入设备设置页，确认设备的where参数确实显示为修改后的新值，排除弱网环境下操作没保存到服务端的情况。
• 排除同步延迟影响：SDM API的设备属性、关联关系不是实时同步的，常规同步延迟在1分钟到15分钟不等，修改后立刻调用大概率拿到旧缓存数据。可以等待20分钟以上，跳过本地缓存发送全新请求测试，不要复用之前请求的客户端缓存结果。
• 检查接口和权限配置：确认你调用的是正式v1版本的SDM接口，设备列表接口路径为/v1/enterprises/{projectId}/devices，不要使用已经废弃的旧版Works with Nest接口，旧接口不会同步新的房间绑定关系。同时到对应Google Cloud项目的权限页确认，你的应用已经申请了sdm.devices.get、sdm.structures.get的权限scope，缺少结构读取权限时，API会返回缓存的旧关联数据，不会拉取最新的绑定关系。
• 确认房间资源已同步到服务端：SDM API中parentRelation关联的是房间（room）层级资源，如果你只是修改了家庭（structure）名称、或者把设备移到了未在SDM侧同步的自定义房间，也会出现返回值不更新的问题。可以先调用结构列表接口/v1/enterprises/{projectId}/structures，查看返回结果里对应结构下的房间列表，是否包含你修改后的目标房间，确认房间资源已经在服务端生成。

解决方法 #

• 如果是操作未生效：重新在Nest应用中修改设备位置，修改后停留3-5秒等页面提示保存成功，退出重进确认位置显示为新值后再等待同步。
• 如果是缓存命中导致数据不更新：等待同步窗口后仍返回旧值的，可以重新生成OAuth2凭据再发起请求，新凭据不会命中旧的权限缓存，一般能拉取到最新的设备关联数据。
• 如果是接口/权限配置错误：补全所需的权限scope，重新走OAuth授权流程给应用授予完整的设备、结构读取权限，切换到v1版本正式接口后再调用。
• 以上操作都无效的，可以将对应设备断电10秒后重新上电，等设备重新上线连接到Nest服务时，会主动上报一次自身的所属位置信息，一般10分钟内再调用API就能拿到更新后的parentRelation值。

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