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

غير قابل للتغيير. عنوان URL للمكان الذي تم تنزيل ملف الوسائط الأصلي منه (أو لاسم ملف) يُستخدم فقط للوسائط من النوع "AUDIO" و"IMAGE".
name

string

غير قابل للتغيير. اسم ملف الوسائط يمكن للبرامج استخدام الاسم للمساعدة في تحديد الوسائط التي تم تحميلها سابقًا.
fileSize

string (int64 format)

النتائج فقط. حجم ملف الوسائط بالبايت.
حقل الاتحاد mediatype تمثّل هذه السمة النوع المحدد من ملف الوسائط. يمكن أن تكون السمة "mediatype" واحدة فقط مما يلي:
image

object (MediaImage)

غير قابل للتغيير. تركيب صورة.
mediaBundle

object (MediaBundle)

غير قابل للتغيير. وسائط أرشيف ZIP يحتوي محتواها على مواد عرض HTML5.
audio

object (MediaAudio)

النتائج فقط. تغليف صوت.
video

object (MediaVideo)

غير قابل للتغيير. فيديو.

MediaType

نوع الوسائط.

عمليات التعداد
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

النتائج فقط. عنوان URL لنسخة الحجم الكامل من الصورة.
previewSizeImageUrl

string

النتائج فقط. عنوان URL لنسخة حجم المعاينة من الصورة.

MediaBundle

يمثّل هذا النوع وسائط أرشيف ZIP يحتوي محتواها على مواد عرض HTML5.

تمثيل JSON 
{
  "data": string,
  "url": string
}
الحقول
data

string (bytes format)

غير قابل للتغيير. البيانات المضغوطة الأولية:

سلسلة بترميز base64.
url

string

النتائج فقط. عنوان URL للوصول إلى البيانات المضغوطة التي تم تحميلها. على سبيل المثال، 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 على YouTube). عند إضافة البادئة "https://www.youtube.com/watch?v=" إلى هذا المعرّف، ستحصل على عنوان URL لبث هذا الفيديو على YouTube.
advertisingIdCode

string

النتائج فقط. رمز التعريف الرقمي للإعلان لهذا الفيديو، كما هو محدد من قبل الرابطة الأمريكية للوكالات الإعلانية، ويُستخدم بشكل أساسي للإعلانات التلفزيونية.
isciCode

string

النتائج فقط. رمز المعرّف التجاري القياسي في المجال لهذا الفيديو، ويُستخدم بشكل أساسي للإعلانات التلفزيونية.