MediaFile

یک فایل رسانه ای

نمایندگی JSON
{
  "resourceName": string,
  "type": enum (MediaType),
  "mimeType": enum (MimeType),
  "id": string,
  "sourceUrl": string,
  "name": string,
  "fileSize": string,

  // Union field mediatype can be only one of the following:
  "image": {
    object (MediaImage)
  },
  "mediaBundle": {
    object (MediaBundle)
  },
  "audio": {
    object (MediaAudio)
  },
  "video": {
    object (MediaVideo)
  }
  // End of list of possible types for union field mediatype.
}
زمینه های
resourceName

string

تغییرناپذیر. نام منبع فایل رسانه. نام منابع فایل های رسانه ای به شکل زیر است:

customers/{customerId}/mediaFiles/{media_file_id}

type

enum ( MediaType )

تغییرناپذیر. نوع فایل رسانه ای

mimeType

enum ( MimeType )

فقط خروجی نوع mime فایل رسانه.

id

string ( int64 format)

فقط خروجی شناسه فایل رسانه ای.

sourceUrl

string

تغییرناپذیر. نشانی اینترنتی جایی که فایل رسانه اصلی از آنجا دانلود شده است (یا نام فایل). فقط برای رسانه های نوع AUDIO و IMAGE استفاده می شود.

name

string

تغییرناپذیر. نام فایل رسانه ای. این نام می تواند توسط مشتریان برای کمک به شناسایی رسانه های بارگذاری شده قبلی استفاده شود.

fileSize

string ( int64 format)

فقط خروجی اندازه فایل رسانه ای بر حسب بایت

mediatype اتحادیه نوع خاص فایل رسانه ای. mediatype تنها می تواند یکی از موارد زیر باشد:
image

object ( MediaImage )

تغییرناپذیر. یک تصویر را کپسوله می کند.

mediaBundle

object ( MediaBundle )

تغییرناپذیر. یک رسانه آرشیو ZIP که محتوای آن حاوی دارایی های HTML5 است.

audio

object ( MediaAudio )

فقط خروجی یک صدا را در بر می گیرد.

video

object ( MediaVideo )

تغییرناپذیر. یک ویدیو را کپسوله می کند.

نوع رسانه

نوع رسانه

Enums
UNSPECIFIED نوع رسانه مشخص نشده است.
UNKNOWN

مقدار دریافتی در این نسخه مشخص نیست.

این یک مقدار فقط پاسخگویی است.

IMAGE تصویر ایستا، برای تبلیغات تصویری استفاده می شود.
ICON تصویر کوچک، برای تبلیغات نقشه استفاده می شود.
MEDIA_BUNDLE فایل ZIP، مورد استفاده در زمینه های تبلیغات الگو.
AUDIO فایل صوتی.
VIDEO فایل ویدیویی.
DYNAMIC_IMAGE تصویر متحرک، مانند GIF متحرک.

MediaImage

یک تصویر را کپسوله می کند.

نمایندگی JSON
{
  "data": string,
  "fullSizeImageUrl": string,
  "previewSizeImageUrl": string
}
زمینه های
data

string ( bytes format)

تغییرناپذیر. داده های تصویر خام

رشته ای با کد base64.

fullSizeImageUrl

string

فقط خروجی آدرس اینترنتی تصویر در اندازه کامل.

previewSizeImageUrl

string

فقط خروجی نشانی اینترنتی نسخه اندازه پیش نمایش تصویر.

MediaBundle

نشان دهنده یک رسانه آرشیو ZIP است که محتوای آن حاوی دارایی های HTML5 است.

نمایندگی JSON
{
  "data": string,
  "url": string
}
زمینه های
data

string ( bytes format)

تغییرناپذیر. داده های فشرده خام

رشته ای با کد base64.

url

string

فقط خروجی آدرس اینترنتی برای دسترسی به داده های فشرده آپلود شده. برای مثال، https://tpc.googlesyndication.com/simgad/123 این فیلد فقط خواندنی است.

MediaAudio

یک صدا را در بر می گیرد.

نمایندگی JSON
{
  "adDurationMillis": string
}
زمینه های
adDurationMillis

string ( int64 format)

فقط خروجی مدت زمان صدا بر حسب میلی ثانیه.

MediaVideo

یک ویدیو را کپسوله می کند.

نمایندگی JSON
{
  "adDurationMillis": string,
  "youtubeVideoId": string,
  "advertisingIdCode": string,
  "isciCode": string
}
زمینه های
adDurationMillis

string ( int64 format)

فقط خروجی مدت زمان ویدیو بر حسب میلی ثانیه.

youtubeVideoId

string

تغییرناپذیر. شناسه ویدیوی YouTube (همانطور که در URLهای یوتیوب مشاهده می شود). با افزودن پیشوند "https://www.youtube.com/watch?v=" به این شناسه، URL پخش جریانی YouTube برای این ویدئو دریافت می شود.

advertisingIdCode

string

فقط خروجی کد شناسایی دیجیتال تبلیغاتی برای این ویدیو، همانطور که توسط انجمن آژانس های تبلیغاتی آمریکا تعریف شده است، عمدتاً برای تبلیغات تلویزیونی استفاده می شود.

isciCode

string

فقط خروجی کد شناسه تجاری استاندارد صنعتی برای این ویدیو، که عمدتاً برای تبلیغات تلویزیونی استفاده می شود.