AppGallery Console中REST API创建的Deeplink不显示问题咨询

• 接口参数不匹配：调用Deeplink创建REST API时，漏传appId、projectId这类和AG Console项目强绑定的必填标识，或者传的ID和你当前登录Console选中的项目、应用ID对不上，后端会把这条Deeplink归到其他项目的资源池，当前视图自然拉取不到数据。
• 数据同步存在时间差：API创建的Deeplink数据不会实时写入Console前端查询的展示库，正常同步窗口是1-5分钟，要是用的是跨区域部署的服务节点，延迟可能会更长。
• 权限配置不匹配：调用API用的密钥/客户端凭证所属的账号，没有对应项目下Deeplink资源的Console查看权限，或者创建时把资源标记成了仅API可见，没开Console展示权限。
• 资源类型传错：调API的时候把Deeplink的类型字段填成了App Linking的其他子类型，比如邀请链接、营销活动专属链接，这类资源默认不会出现在通用Deeplink列表里，会被归到对应功能模块下。
• 接口环境用错：如果调API的时候用的不是官方生产域，或者连的是测试环境的接口端点，创建出来的测试数据根本不会同步到生产环境AG Console的展示库。

• 先核API请求参数：把调用创建接口的全量请求日志拉出来，重点核对projectId、appId的取值，和你当前AG Console页面顶部选的项目、左侧应用列表选的应用ID完全一致；同时检查linkType、visibility这两个字段的取值，确认资源类型是通用Deeplink、可见范围包含Console展示。
• 再查调用凭证权限：确认调接口用的API密钥所属的服务账号/子账号，已经被授予当前项目下App Linking服务的查看、管理权限，且账号没被加进做了资源隔离的用户组。
• 验证资源创建状态：调用Deeplink查询类REST API，传入创建成功时返回的deepLinkId，确认资源本身确实创建成功、状态是生效态，排除接口实际调用失败、本地误判创建成功的情况。
• 等同步窗口后刷新验证：创建完成后等10分钟以上，清掉浏览器缓存重新登录AG Console进Deeplink列表，同时把列表的筛选条件（创建时间范围、链接状态）都重置下，确认是不是被筛选规则过滤掉了。
• 核对接口调用端点：确认发请求的地址是对应区域的正式生产环境接口地址，没误用沙箱、测试环境的接口域名。

• 参数错误场景：把API请求里的项目、应用标识字段改对，补上缺失的可见性配置，重新提交创建请求，等3-5分钟刷新Console列表就能看到对应条目。
• 同步延迟场景：如果用查询API确认Deeplink已经创建成功、状态正常，最长等2小时（跨区域场景的最大同步延迟阈值）就会自动展示，不需要额外操作。
• 权限不匹配场景：给API调用对应的账号补上当前项目App Linking服务的管理、查看权限，同时把已经创建的Deeplink资源可见范围调整为Console可见，调整后等10分钟左右刷新页面就能看到。
• 类型/环境错误场景：要是传错了链接类型，直接去对应功能模块（比如活动运营、用户邀请板块）找对应链接就行；要是是调用测试环境接口创建的测试数据，得切到生产环境接口重新创建正式资源，才会在生产Console展示。
• 兜底处理：如果以上步骤都排查完确认没问题，链接还是不展示，可以直接在AG Console提交工单，附上API调用的请求ID、返回的deepLinkId、具体调用时间，让后台运维人员手动触发数据同步修复就行。

内容的提问来源于stack exchange，提问作者Punit Kumar Gupta