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

ประเภทของสื่อ

Enum
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 สำหรับเข้าถึงข้อมูลแบบ Zip ที่อัปโหลดแล้ว เช่น 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

เอาต์พุตเท่านั้น รหัสตัวระบุเชิงพาณิชย์ตามมาตรฐานอุตสาหกรรมของวิดีโอนี้ ซึ่งใช้สำหรับโฆษณาทางโทรทัศน์เป็นหลัก