饿了么开放平台视频服务接入指南
背景说明
为方便商家在用户端展示更具体、更真实的菜品信息,通过全方位的信息展示带来更高的订单转化。饿了么目前支持用户点餐时进入商品详情页查看短视频。开放平台同步支持商家上传短视频,关联菜品后在用户端展示,利用独特的短视频内容调性,为商户提供差异化运营工具。
上传视频操作说明
开放平台目前已支持开发者使用sdk上传视频,请查看OAuthClientDemo内的testVideoUpload方法
视频要求:格式:mp4、mov;大小:小于等于300M; 时长:小于等于300秒
上传视频操作,建议开发者直接使用平台提供的sdk即可,开放平台已将获取上传视频token接口和发布视频信息接口封装到一个接口uploadVideoClient。因此,用户只需要提供视频的本地地址(必选),视频标题(必选),视频场景码(必选 目前场景码有: OPEN_API_ALSC_PC_SELLER_CP_VIDEO),视频封面图起始时间(可选),视频封面图url地址(可选),在成功上传视频后,通过发布视频接口即可返回视频Id。
视频上传的具体流程如下:
上传视频token获取。用户通过传入场景码调用eleme.content.getUploadToken接口,返回上传token。此处参数细节说明请参考接口文档;
使用sdk初始化EfsMediaClient实例。不同语言的sdk请参考其中EfsMediaClient中的init()方法。此处需要传入上传token;
EfsMediaClient实例调用uploadVideo方法上传视频,成功后返回视频fileId(视频资源Id);
视频内容发布,调用eleme.content.publishVideoContent 视频发布接口,执行视频发布流程,成功返回videoId。参考接口文档。
建立视频和商品关联操作说明:
调用eleme.product.item.bindVideo 绑定商品和视频关联关系。参考接口文档
调用eleme.product.item.unbindVideo 解绑商品和视频关联关系。参考接口文档
注: 具体参数细节说明,请仔细阅读视频服务文档说明