---
title: "ExternalVideo"
description: "表示在 Shopline 之外托管的视频"
doc_type: graphql
doc_category: storefront
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/external-video'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/external-video.md'
---
# ExternalVideo

表示在 Shopline 之外托管的视频

- **API Version:** v20270301
- **API Type:** Storefront
- **API Protocol:** GraphQL
- **Operation Type:** Object

## Type Signature

`ExternalVideo`

## Fields

* `alt`

  [String](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md)

  分享媒体性质或内容的单词或短语

* `host`

  [MediaHost!](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/enums/media-host.md)

  外部视频的主机

* `id`

  [ID!](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/id.md)

  全局唯一的媒体ID

* `mediaContentType`

  [MediaContentType!](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/enums/media-content-type.md)

  媒体内容类型

* `originalUrl`

  [String!](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md)

  相应主机上视频的原始 URL

* `previewImage`

  [Image](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common-objects/objects/image.md)

  媒体的预览图像

## Schema Definition

```graphql
type ExternalVideo { 
	alt: String
	host: MediaHost!
	id: ID!
	mediaContentType: MediaContentType!
	originalUrl: String!
	previewImage: Image 
}
```

## Error Handling

关于更多通用错误码说明，参考：[状态码和错误码](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/storefront-api/overview.md#status-and-error-codes)。