REST Resource: videoContent.networks.sources.content

แหล่งข้อมูล: เนื้อหาวิดีโอ

ข้อมูลเมตาของเนื้อหา

การแสดง JSON 
{
  "name": string,
  "status": enum (VideoContentStatus),
  "title": string,
  "updateTime": string,
  "publishTime": string,
  "duration": string,
  "cuePoints": [
    string
  ],
  "thumbnailUrl": string,
  "metadata": {
    object (Metadata)
  },
  "gracenoteMetadata": {
    object (GracenoteMetadata)
  },
  "syndicationMetadata": {
    object (VideoContentSyndicationInfo)
  },
  "dynamicAdInsertionMetadata": {
    object (DynamicAdInsertionInfo)
  }
}
ช่อง
name

string

เอาต์พุตเท่านั้น ชื่อทรัพยากรของเนื้อหาวิดีโอ ช่องนี้มีรูปแบบ 'networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}'

network_code คือรหัสเครือข่ายใน Google Ad Manager ที่เป็นเจ้าของเนื้อหานี้

content_source_id คือรหัสแหล่งที่มาของเนื้อหาใน Google Ad Manager ซึ่งควรมีเนื้อหานี้

cms_content_id คือรหัสเนื้อหา CMS ใน Google Ad Manager ซึ่งเป็นส่วนหนึ่งของคําขอโฆษณาเพื่อระบุว่า Ad Manager จะแสดงโฆษณารายการใดได้บ้างให้กับวิดีโอที่เกี่ยวข้อง ค่านี้อาจเป็นตัวเลขหรือตัวอักษรและตัวเลข
status

enum (VideoContentStatus)

สถานะของเนื้อหา หากไม่ระบุ ค่าเริ่มต้นจะทํางาน
title

string

ต้องระบุ ชื่อเนื้อหา
updateTime

string (Timestamp format)

ต้องระบุ เวลาที่แก้ไขล่าสุดของเนื้อหา

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดในระดับนาโนวินาทีและอาจใช้ตัวเลขไม่เกิน 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
publishTime

string (Timestamp format)

เวลาเผยแพร่เนื้อหา ช่องนี้เป็นช่องที่ต้องกรอกหากวิดีโอออกแบบมาเพื่อรวมอยู่ในกฎโฆษณาที่ระบุเวลาเริ่มต้นและเวลาสิ้นสุด

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดในระดับนาโนวินาทีและอาจใช้ตัวเลขไม่เกิน 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
duration

string (Duration format)

ระยะเวลาของเนื้อหา มีการรองรับระยะเวลาเป็นระดับมิลลิวินาที

ระยะเวลาเป็นวินาทีที่มีตัวเลขไม่เกิน 9 หลักที่ลงท้ายด้วย 's' ตัวอย่าง: "3.5s"
cuePoints[]

string (Duration format)

ระบุจุดเริ่มโฆษณา จุดเริ่มโฆษณาคือจุดในเวลาที่แทรกโฆษณาได้ในวิดีโอ จุดเริ่มโฆษณาจะอยู่ที่ระดับมิลลิวินาที ช่องนี้เป็นช่องที่ต้องกรอกหากวิดีโอมีช่วงพักโฆษณาตอนกลาง

ระยะเวลาเป็นวินาทีที่มีตัวเลขไม่เกิน 9 หลักที่ลงท้ายด้วย 's' ตัวอย่าง: "3.5s"
thumbnailUrl

string

URL ภาพขนาดย่อของเนื้อหา
metadata

object (Metadata)

ระบุข้อมูลเมตาที่กําหนดเองของเนื้อหา
gracenoteMetadata

object (GracenoteMetadata)

ข้อมูลเมตาที่เกี่ยวข้องกับ Gracenote
syndicationMetadata

object (VideoContentSyndicationInfo)

ข้อมูลเมตาที่เกี่ยวข้องกับการเผยแพร่ของเนื้อหา
dynamicAdInsertionMetadata

object (DynamicAdInsertionInfo)

ข้อมูลเมตาที่เกี่ยวข้องกับการแทรกโฆษณาแบบไดนามิกของเนื้อหา

สถานะเนื้อหาวิดีโอ

ตัวเลือกสถานะว่าจะแสดงหรือไม่แสดงโฆษณาที่ตรงเป้าหมายสําหรับเนื้อหา

Enum
ACTIVE ระบบจะแสดงโฆษณาที่กําหนดเป้าหมายตามเนื้อหา
BLOCKED จะไม่มีการแสดงโฆษณาสําหรับเนื้อหานี้หากสถานะเป็น "ถูกบล็อก"
DELETED ระบบจะเก็บเนื้อหาใน Ad Manager หาก Ad Manager ได้รับคําขอโฆษณาสําหรับเนื้อหาที่ทําเครื่องหมายว่า "ลบ" โฆษณาเฮาส์แอ็ดหรือโฆษณาที่กําหนดเป้าหมายไปยังหน่วยพื้นที่โฆษณาหรือเกณฑ์การกําหนดเป้าหมายอื่นๆ จะยังคงแสดงได้ ตั้งค่าสถานะเป็น "บล็อกโฆษณา" เพื่อบล็อกโฆษณา

ข้อมูลเมตา

ข้อมูลเมตาที่กําหนดเองของเนื้อหา

การแสดง JSON 
{
  "keyValues": {
    string: value,
    ...
  }
}
ช่อง
keyValues

map (key: string, value: value (Value format))

ระบุข้อมูลเมตาที่กําหนดเองของเนื้อหาเป็นคู่คีย์-ค่า ระบบยอมรับเฉพาะค่าสตริงหรือรายการสตริงเท่านั้น

ข้อมูลเมตา Gracenote

ข้อมูลเมตา Gracenote สําหรับเนื้อหา

การแสดง JSON 
{
  "gracenoteId": string,
  "gracenoteSeriesId": string
}
ช่อง
gracenoteId

string

ต้องระบุ โปรดดูรหัส Gracenote สําหรับเนื้อหา ต้องมีคํานําหน้าที่ถูกต้องต่อไปนี้ 1 รายการ 'EP' - ตอนที่ 2 'MV' - ภาพยนตร์ 3 'SP' - การแข่งขันกีฬา
gracenoteSeriesId

string

ไม่บังคับ ช่องนี้หมายถึงรหัสชุด Gracenote ต้องขึ้นต้นด้วย 'SH'

ข้อมูลการเผยแพร่เนื้อหาวิดีโอ

ข้อมูลเมตาสําหรับการระบุความสัมพันธ์ระหว่างเนื้อหา Canonical และเนื้อหาที่คัดลอกมา

การแสดง JSON 
{

  // Union field syndication can be only one of the following:
  "canonicalVideoContent": string,
  "syndicatedVideoContentNames": {
    object (SyndicatedVideoContentNames)
  }
  // End of list of possible types for union field syndication.
}
ช่อง
ช่อง Union syndication VideoContentSyndiationMetadata สามารถมีได้อย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น syndication ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
canonicalVideoContent

string

ชื่อของเนื้อหา Canonical โดยต้องอยู่ในรูปแบบ "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" และต้องเป็นเครือข่ายเดียวกันกับเนื้อหาที่มีช่องนี้
syndicatedVideoContentNames

object (SyndicatedVideoContentNames)

คอลเล็กชันของเนื้อหาที่คัดลอกมา

ชื่อเนื้อหาวิดีโอที่เผยแพร่

รายชื่อเนื้อหาที่คัดลอกมาทั้งหมด

การแสดง JSON 
{
  "syndicatedVideoContent": [
    string
  ]
}
ช่อง
syndicatedVideoContent[]

string

ช่องที่ซ้ําของชื่อเนื้อหาที่คัดลอกมา โดยต้องอยู่ในรูปแบบ "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" และต้องอยู่ในเครือข่ายเดียวกับเนื้อหาที่มีช่องนี้

ข้อมูลการแทรกโฆษณาแบบไดนามิก

ข้อมูลที่เกี่ยวข้องกับการแทรกโฆษณาแบบไดนามิก

การแสดง JSON 
{
  "videoIngestUrlInfo": {
    object (VideoIngestUrlInfo)
  },
  "mediaUpdateTime": string,
  "closedCaptionUrlInfo": [
    {
      object (ClosedCaptionUrlInfo)
    }
  ],
  "fwCaid": string
}
ช่อง
videoIngestUrlInfo

object (VideoIngestUrlInfo)

ลิงก์ไปยังไฟล์ m3u8 หลักที่ใช้ในการกําหนดเงื่อนไขและสร้างเพลย์ลิสต์
mediaUpdateTime

string (Timestamp format)

เวลาที่แก้ไขไฟล์วิดีโอที่อ้างอิงใน videoIngestUrlInfo

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดในระดับนาโนวินาทีและอาจใช้ตัวเลขไม่เกิน 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
closedCaptionUrlInfo[]

object (ClosedCaptionUrlInfo)

URL ไปยังไฟล์คําอธิบายภาพ/คําบรรยาย
fwCaid

string

รหัสเนื้อหาที่กําหนดเองของ FreeWheel ที่ใช้ในการกําหนดเป้าหมายโฆษณา

ข้อมูล IngestUrlข้อมูลวิดีโอ

ข้อมูลเมตาที่ระบุลิงก์ไปยังไฟล์ m3u8 ที่ใช้สําหรับการกําหนดเงื่อนไขและการสร้างเพลย์ลิสต์

การแสดง JSON 
{
  "videoFormat": enum (VideoFormat),
  "videoPreconditioned": enum (VideoPreconditioned),
  "url": string
}
ช่อง
videoFormat

enum (VideoFormat)

รูปแบบของวิดีโอ
videoPreconditioned

enum (VideoPreconditioned)

เพื่อระบุว่ามีการปรับสภาพเนื้อหาสําหรับโฆษณาตอนกลางหรือยัง ซึ่งหมายความว่ามีการแยกกลุ่มของคุณไว้แล้วเมื่อถึงช่วงพักโฆษณา
url

string

ลิงก์ไปยังไฟล์ m3u8

รูปแบบวิดีโอ

รูปแบบที่อาจเข้ารหัสเนื้อหาวิดีโอ

Enum
VIDEO_FORMAT_UNSPECIFIED ไม่ได้ระบุรูปแบบวิดีโอ
HLS แอปพลิเคชัน/x-mpegURL
DASH แอปพลิเคชัน/ขีดกลาง+xml

ปรับสภาพวิดีโอล่วงหน้า

สถานะแบบมีเงื่อนไขของเนื้อหาวิดีโอ

Enum
NO ยังไม่ได้ปรับสภาพ
YES วิดีโอมีการปรับสภาพ/แยกออกแล้ว

ข้อมูล URL คําอธิบายภาพ

ข้อมูลเมตาสําหรับไฟล์คําบรรยายไฟล์เดียว

การแสดง JSON 
{
  "languageCode": string,
  "closedCaptionFormat": enum (ClosedCaptionFormat),
  "url": string
}
ช่อง
languageCode

string

รหัสภาษา IETF BCP-47 ที่แทนภาษาของไฟล์คําบรรยาย
closedCaptionFormat

enum (ClosedCaptionFormat)

รูปแบบของไฟล์คําอธิบายภาพ
url

string

URL ไปยังไฟล์คําบรรยาย

รูปแบบคําบรรยาย

รูปแบบของไฟล์คําอธิบายภาพ

Enum
CLOSED_CAPTION_FORMAT_UNSPECIFIED ไม่ได้ระบุรูปแบบคําบรรยาย
TTML แอปพลิเคชัน/ttaf+xml
WEB_VTT ข้อความ/VT

วิธีการ

update

 API เพื่อสร้างเนื้อหาใหม่หรืออัปเดตข้อมูลเมตาหากมีเนื้อหานั้นอยู่ใน Ad Manager แล้ว