---
title: "external_video"

doc_type: static
doc_category: static
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/sline/object/external-video'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/sline/object/external-video.md'
---

# external_video


    在 SHOPLINE 之外的平台上托管的视频。

    



    <div>
    
        #### 属性

        
<ObjectProperty
    name="alt"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
视频无法显示时展示的替代文本。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="aspect_ratio"
    types={[<Mdx>float</Mdx>]}
>
<ObjectSummary>
视频播放器的宽高比。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="external_id"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
视频在其外部托管平台上的唯一标识符 ID。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="host"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
外部视频托管平台的名称。仅支持 YouTube 和 Vimeo。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="id"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
SHOPLINE 系统为视频分配的唯一标识符 ID。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="media_type"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
媒体资源类型。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="position"
    types={[<Mdx>integer</Mdx>]}
>
<ObjectSummary>
视频在列表或页面中的位置序号，用于多个视频情况下控制视频的展示顺序。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="preview_image"
    types={[<Mdx>[image](https://developer.shopline.com/zh-hans-cn/docs/sline/object/image.md)</Mdx>]}
>
<ObjectSummary>
视频的预览图像，即视频加载之前显示的缩略图或封面图。


</ObjectSummary>
</ObjectProperty>
        
    
    </div>