Google App Maker用户选择器无法返回缩略图问题求助

我之前维护G Suite集成的App Maker应用时，碰到过几乎一模一样的问题——用户数据能正常拉取，缩略图URL看起来和之前完全一致，但就是加载不出来。结合你的情况，排除代码逻辑问题后，这些是最可能的原因和对应的排查修复步骤：

• G Suite Directory API权限调整

  Google偶尔会微调API的访问权限策略，哪怕URL结构没变，现在可能需要额外的授权才能获取用户缩略图。你可以：

  1. 检查App Maker项目的OAuth scopes，确认是否包含https://www.googleapis.com/auth/admin.directory.user.readonly（这个权限是读取用户基本信息包括缩略图的关键）
  2. 如果你的应用使用了服务账号访问Directory API，登录Google Admin Console，确保服务账号被授予了查看用户信息的域权限，没有的话需要在「权限」-「高级权限」里添加对应角色。

• 客户端缓存导致的旧失效响应

  浏览器缓存有时候会“记住”之前的加载失败状态，哪怕URL已经恢复正常。你可以快速验证：

  • 用无痕/隐私模式打开票务终端，看看缩略图是否能加载
  • 临时给缩略图URL添加一个随机参数（比如绑定表达式改成{{user.ThumbnailPhotoUrl}}?refresh={{Date.now()}}），强制浏览器请求新资源。如果这样能显示，就说明是缓存问题，后续可以考虑清除终端设备的浏览器缓存，或者调整组件的缓存策略。

• 用户或全局隐私设置变更

  有些用户可能修改了自己的G Suite个人资料隐私设置，把图片设为仅自己可见或仅特定群体可见；或者域管理员调整了全局的用户信息访问权限。你可以：

  • 找一个测试用户，让他们检查自己的Google Workspace个人资料，确认“图片可见范围”设置是否包含你的应用所在的域
  • 登录Admin Console，在「用户」-「用户设置」里查看「个人资料共享」相关的配置，确保允许应用访问用户缩略图。

• Image组件的隐性渲染问题

  虽然你说代码没问题，但有时候App Maker的组件绑定会有隐性的解析错误。你可以：

  1. 直接复制ThumbnailPhotoUrl到浏览器地址栏，手动访问看看是否能打开图片——如果能打开，说明是组件的问题
  2. 检查Image组件的ImageUrl绑定表达式，确认没有多余的空格或转义字符；同时检查组件的Visible、Enabled属性是否被意外设置为false。

• Directory API端点的隐性变更

  Google偶尔会在不修改URL格式的情况下更新API端点的后端逻辑。你可以尝试通过Directory API的测试工具手动调用users.get接口，获取目标用户的信息，对比返回的thumbnailPhotoUrl和你应用中拿到的是否一致，同时测试这个API返回的URL是否能正常加载。如果API返回的URL能加载，但应用中的不行，可能是数据同步的问题，需要检查你的数据拉取逻辑是否有缓存旧数据的情况。

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