求助：使用Node.js SDK从Cloudinary获取图片元数据的问题

问题1：cloudinary.api.list_metadata_fields()返回空数组的原因及解决 #

• 未创建自定义元数据字段：Cloudinary的元数据字段需先在控制台手动创建——登录Cloudinary后台，进入Settings > Metadata Fields，点击添加字段（比如命名为image_description），创建后API才会返回已定义的字段列表。
• API权限不足：确认使用的Cloudinary API密钥具备Admin权限，受限或只读密钥无法访问Metadata API。
• SDK版本过旧：旧版Node.js SDK对Metadata API支持不完善，执行npm install cloudinary@latest升级到最新版。
• 调用参数错误：检查调用时是否添加了不必要的过滤参数，确保调用形式为cloudinary.api.list_metadata_fields()，无额外限制条件。

问题2：获取图片自定义描述元数据并关联到图片对象 #

1. 提前准备：确保已在Cloudinary控制台创建自定义元数据字段（如image_description），并给目标图片设置对应的值（比如“California Horses #1”）——可通过控制台批量编辑，或用API批量更新：

   // 批量给图片设置元数据
   await cloudinary.api.update_metadata(
     ['image_description'],
     { values: { 'image_description': 'California Horses #1' } },
     { public_ids: ['your-image-public-id-1', 'your-image-public-id-2'] }
   );
   

2. 获取资源时携带元数据：调用cloudinary.api.resources()时，添加metadata参数指定要获取的字段（或设为true获取所有元数据），示例：

   const galleryResources = await cloudinary.api.resources({
     type: 'upload',
     metadata: true, // 或指定具体字段数组：['image_description']
     max_results: 100 // 根据需求调整返回数量
   });
   

3. 关联数据：返回的每个资源对象中会包含metadata属性，直接提取对应字段值即可和图片URL绑定：

   // 处理资源数据，生成画廊所需结构
   const galleryItems = galleryResources.resources.map(item => ({
     url: item.secure_url,
     description: item.metadata?.image_description || '无描述'
   }));
   

   之后将galleryItems传给前端React组件，渲染滚动画廊即可。

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