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)

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

VideoContentStatus

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

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

ข้อมูลเมตา

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

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

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

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

GracenoteMetadata

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

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

string

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

string

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

VideoContentSyndicationInfo

ข้อมูลเมตาสำหรับการระบุความสัมพันธ์ระหว่างเนื้อหา 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.
}
ช่อง
ช่องการรวม syndication VideoContentSyndiationMetadata สามารถประกอบด้วยค่าใดข้อมูลหนึ่งต่อไปนี้เท่านั้น syndication ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
canonicalVideoContent

string

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

object (SyndicatedVideoContentNames)

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

SyndicatedVideoContentNames

รายชื่อของเนื้อหาที่เผยแพร่ทั้งหมด

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

string

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

DynamicAdInsertionInfo

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

การแสดง 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 ซึ่งใช้สำหรับการกำหนดเป้าหมายโฆษณา

VideoIngestUrlInfo

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

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

enum (VideoFormat)

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

enum (VideoPreconditioned)

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

string

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

VideoFormat

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

Enum
VIDEO_FORMAT_UNSPECIFIED ไม่ได้ระบุรูปแบบวิดีโอ
HLS application/x-mpegURL
DASH application/dash+xml

VideoPreconditioned

สถานะที่ปรับสภาพของเนื้อหาวิดีโอ

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

ClosedCaptionUrlInfo

ข้อมูลเมตาสำหรับไฟล์คำบรรยายแทนเสียงไฟล์เดียว

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

string

รหัสภาษา IETF BCP-47 ที่แสดงถึงภาษาที่ใช้ในไฟล์คำบรรยายแทนเสียง
closedCaptionFormat

enum (ClosedCaptionFormat)

รูปแบบของไฟล์คำบรรยายแทนเสียง
url

string

URL ไปยังไฟล์คำบรรยายแทนเสียง

ClosedCaptionFormat

รูปแบบไฟล์คำบรรยายแทนเสียง

Enum
CLOSED_CAPTION_FORMAT_UNSPECIFIED ไม่ได้ระบุรูปแบบคำบรรยาย
TTML application/ttaf+xml
WEB_VTT text/vtt

เมธอด

update

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