Package google.ads.drx.video.v1

ดัชนี

VideoContentIngestionService

บริการ API สำหรับการนำเข้าเนื้อหาที่อนุญาตให้สร้างหรืออัปเดตเนื้อหาวิดีโอและข้อมูลเมตาที่เกี่ยวข้องใน Google Ad Manager

UpdateVideoContent

rpc UpdateVideoContent(UpdateVideoContentRequest) returns (VideoContent)

API สำหรับสร้างเนื้อหาใหม่หรืออัปเดตข้อมูลเมตาของเนื้อหา หากเนื้อหามีอยู่ใน Ad Manager อยู่แล้ว แสดงเนื้อหาเมื่อสำเร็จหรือ google.rpc.Code เมื่อไม่สำเร็จ

ตัวอย่างคำขอมีลักษณะดังนี้

{
   "status": "ACTIVE",
   "title": "Best video ever",
   "updateTime": "2019-01-24T01:30:15.01Z",
   "duration": "230s",
   "cuePoints": ["55.532s", "192s"],
   "publishTime": "2019-01-24T01:30:15.01Z",
   "thumbnailUrl": "http://www.domain.com/tn.jpg",
   "metadata": {
       "keyValues": {
           "category": "sports",
           "tag": ["soccer", "messi"],
       }
   }
}
ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/contentingestion
  • https://www.googleapis.com/auth/video-ads

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0

ClosedCaptionFormat

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

Enum
CLOSED_CAPTION_FORMAT_UNSPECIFIED ไม่ได้ระบุรูปแบบคำบรรยายแทนเสียง
TTML application/ttaf+xml
WEB_VTT ข้อความ/vtt

ClosedCaptionUrlInfo

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

ช่อง
language_code

string

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

ClosedCaptionFormat

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

string

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

DynamicAdInsertionInfo

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

ช่อง
video_ingest_url_info

VideoIngestUrlInfo

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

Timestamp

เวลาที่แก้ไขไฟล์วิดีโอที่อ้างอิงใน video_ingest_url_info ครั้งล่าสุด
closed_caption_url_info[]

ClosedCaptionUrlInfo

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

string

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

GracenoteMetadata

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

ช่อง
gracenote_id

string

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

string

ไม่บังคับ ฟิลด์นี้หมายถึงรหัสซีรีส์ของ Gracenote ต้องขึ้นต้นด้วย "SH"

ข้อมูลเมตา

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

ช่อง
key_values

map<string, Value>

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

SyndicatedVideoContentNames

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

ช่อง
syndicated_video_content[]

string

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

UpdateVideoContentRequest

คำขอสำหรับ [VideoContentIngestionService.UpdateVideoContentRequest][]

ช่อง
video_content

VideoContent

ต้องระบุ ข้อมูลเมตาของเนื้อหา

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

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

ช่อง
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 คือ Content ID ของ CMS ใน Google Ad Manager ซึ่งเป็นส่วนหนึ่งของคำขอโฆษณาเพื่อระบุว่า Ad Manager จะแสดงโฆษณารายการใดได้บ้างให้กับวิดีโอที่เกี่ยวข้อง ค่านี้อาจเป็นตัวเลขหรือตัวอักษรและตัวเลขคละกันก็ได้
status

VideoContentStatus

สถานะของเนื้อหา หากไม่ระบุ ค่าเริ่มต้นจะเป็น "ใช้งานอยู่"
title

string

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

Timestamp

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

Timestamp

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

Duration

ระยะเวลาของเนื้อหา ระบบรองรับระยะเวลาจนถึงระดับมิลลิวินาที
cue_points[]

Duration

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

string

URL ของภาพปกของเนื้อหา
metadata

Metadata

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

GracenoteMetadata

ข้อมูลเมตาที่เกี่ยวข้องของเนื้อหาจาก Gracenote
syndication_metadata

VideoContentSyndicationInfo

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

DynamicAdInsertionInfo

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

VideoContentStatus

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

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

VideoContentSyndicationInfo

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

ช่อง
ฟิลด์ Union syndication VideoContentSyndicationMetadata มีได้เพียงค่าใดค่าหนึ่งต่อไปนี้ syndication ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
canonical_video_content

string

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

SyndicatedVideoContentNames

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

VideoFormat

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

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

VideoIngestUrlInfo

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

ช่อง
video_format

VideoFormat

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

VideoPreconditioned

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

string

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

VideoPreconditioned

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

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