Package google.ads.drx.video.v1

Chỉ mục

VideoContentIngestionService (giao diện)
ClosedCaptionFormat (enum)
ClosedCaptionUrlInfo (thông báo)
DynamicAdInsertionInfo (thông báo)
GracenoteMetadata (thông báo)
Metadata (thông báo)
SyndicatedVideoContentNames (thông báo)
UpdateVideoContentRequest (thông báo)
VideoContent (thông báo)
VideoContentStatus (enum)
VideoContentSyndicationInfo (thông báo)
VideoFormat (enum)
VideoIngestUrlInfo (thông báo)
VideoPreconditioned (enum)

VideoContentIngestionService

Một dịch vụ API để phân tích nội dung, cho phép tạo hoặc cập nhật nội dung video và siêu dữ liệu liên kết của nội dung đó trong Google Ad Manager.

UpdateVideoContent

UpdateVideoContent
`rpc UpdateVideoContent(UpdateVideoContentRequest) returns (VideoContent)` API để tạo nội dung mới hoặc cập nhật siêu dữ liệu của nội dung nếu nội dung đó đã có trong Ad Manager. Trả về nội dung khi thành công hoặc `google.rpc.Code` khi không thành công. Yêu cầu mẫu có dạng như sau: `{ "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"], } } }` Phạm vi cấp phép Yêu cầu một trong các phạm vi OAuth sau: `https://www.googleapis.com/auth/contentingestion` `https://www.googleapis.com/auth/video-ads` Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.

rpc UpdateVideoContent(UpdateVideoContentRequest) returns (VideoContent)

API để tạo nội dung mới hoặc cập nhật siêu dữ liệu của nội dung nếu nội dung đó đã có trong Ad Manager. Trả về nội dung khi thành công hoặc google.rpc.Code khi không thành công.

Yêu cầu mẫu có dạng như sau:

{
   "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"],
       }
   }
}

Phạm vi cấp phép

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.

ClosedCaptionFormat

Định dạng của tệp phụ đề.

Enum
`CLOSED_CAPTION_FORMAT_UNSPECIFIED`	Bạn chưa chỉ định định dạng phụ đề.
`TTML`	application/ttaf+xml
`WEB_VTT`	text/vtt

ClosedCaptionUrlInfo

Siêu dữ liệu cho một tệp phụ đề.

Trường

Trường
`language_code`	`string` Mã ngôn ngữ BCP-47 của IETF đại diện cho ngôn ngữ trong tệp phụ đề.
`closed_caption_format`	`ClosedCaptionFormat` Định dạng của tệp phụ đề.
`url`	`string` URL đến tệp phụ đề.

language_code

string

Mã ngôn ngữ BCP-47 của IETF đại diện cho ngôn ngữ trong tệp phụ đề.

closed_caption_format

ClosedCaptionFormat

Định dạng của tệp phụ đề.

url

string

URL đến tệp phụ đề.

DynamicAdInsertionInfo

Thông tin liên quan đến tính năng Chèn quảng cáo động.

Trường
`video_ingest_url_info`	`VideoIngestUrlInfo` Đường liên kết đến tệp m3u8 chính được dùng để điều chỉnh và tạo danh sách phát.
`media_update_time`	`Timestamp` Thời điểm sửa đổi gần đây nhất của tệp video được tham chiếu trong video_ingest_url_info.
`closed_caption_url_info[]`	`ClosedCaptionUrlInfo` URL đến tệp phụ đề/phụ đề chi tiết.
`fw_caid`	`string` Mã tài sản tuỳ chỉnh Freewheel được dùng để nhắm mục tiêu quảng cáo.

GracenoteMetadata

Siêu dữ liệu Gracenote cho nội dung.

Trường

gracenote_id

string

Bắt buộc. Đề cập đến mã nhận dạng Gracenote của nội dung. Phải có một trong các tiền tố hợp lệ sau: 1. "EP" – tập của một chương trình dài tập 2. "MV" – movie 3. "SP" – sự kiện thể thao

gracenote_series_id

string

Không bắt buộc. Trường này đề cập đến mã nhận dạng loạt chương trình của Gracenote. Phải có tiền tố là "SH".

Metadata

Siêu dữ liệu tuỳ chỉnh của nội dung.

Trường

key_values

map<string, Value>

Xác định siêu dữ liệu tuỳ chỉnh của nội dung dưới dạng một cặp khoá-giá trị. Hệ thống chỉ chấp nhận các chuỗi hoặc danh sách chuỗi cho các giá trị.

SyndicatedVideoContentNames

Danh sách tên của tất cả nội dung tổng hợp.

Trường

Trường
`syndicated_video_content[]`	`string` Trường lặp lại của tên nội dung tổng hợp. Chúng phải có định dạng "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" và phải thuộc cùng một mạng với nội dung chứa trường này.

syndicated_video_content[]

string

Trường lặp lại của tên nội dung tổng hợp. Chúng phải có định dạng "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" và phải thuộc cùng một mạng với nội dung chứa trường này.

UpdateVideoContentRequest

Yêu cầu cho [VideoContentIngestionService.UpdateVideoContentRequest][].

Trường

Trường
`video_content`	`VideoContent` Bắt buộc. Siêu dữ liệu của nội dung.

video_content

VideoContent

Bắt buộc. Siêu dữ liệu của nội dung.

VideoContent

Siêu dữ liệu của nội dung.

Trường
`name`	`string` Chỉ có đầu ra. Tên tài nguyên của nội dung video. Trường này có định dạng: "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" network_code là mã mạng trong Google Ad Manager mà nội dung này thuộc về. content_source_id là mã nhận dạng nguồn nội dung trong Google Ad Manager mà nội dung này thuộc về. cms_content_id là mã nội dung CMS trong Google Ad Manager, được tạo dưới dạng một phần của yêu cầu quảng cáo để xác định quảng cáo mà Ad Manager có thể phân phát cho video tương ứng. Giá trị này có thể là số hoặc chữ số.
`status`	`VideoContentStatus` Trạng thái của nội dung. Nếu bạn bỏ qua thuộc tính này, giá trị mặc định sẽ là đang hoạt động.
`title`	`string` Bắt buộc. Tiêu đề của nội dung.
`update_time`	`Timestamp` Bắt buộc. Thời gian sửa đổi gần đây nhất của nội dung.
`publish_time`	`Timestamp` Thời gian xuất bản nội dung. Đây là trường bắt buộc nếu video được thiết kế để đưa vào Quy tắc quảng cáo chỉ định thời gian bắt đầu và thời gian kết thúc.
`duration`	`Duration` Thời lượng của nội dung. Thời lượng được hỗ trợ đến cấp độ mili giây.
`cue_points[]`	`Duration` Xác định các điểm chỉ dấu. Điểm chèn quảng cáo là các thời điểm khi có thể chèn quảng cáo vào trong video. Điểm tín hiệu được hỗ trợ đến cấp độ mili giây. Đây là trường bắt buộc nếu video có chứa điểm chèn quảng cáo chèn giữa.
`thumbnail_url`	`string` URL hình thu nhỏ của nội dung.
`metadata`	`Metadata` Xác định siêu dữ liệu tuỳ chỉnh của nội dung.
`gracenote_metadata`	`GracenoteMetadata` Siêu dữ liệu liên quan của nội dung do Gracenote cung cấp.
`syndication_metadata`	`VideoContentSyndicationInfo` Siêu dữ liệu liên quan đến việc phân phối nội dung.
`dynamic_ad_insertion_metadata`	`DynamicAdInsertionInfo` Siêu dữ liệu liên quan đến tính năng Chèn quảng cáo động của nội dung.

VideoContentStatus

Các lựa chọn về trạng thái để phân phát hoặc không phân phát quảng cáo được nhắm mục tiêu cho một nội dung.

Enum
`ACTIVE`	Quảng cáo nhắm đến nội dung sẽ được phân phát.
`BLOCKED`	Nếu trạng thái là BLOCKED, thì quảng cáo sẽ không được phân phát cho nội dung này.
`DELETED`	Nội dung sẽ được lưu trữ trong Ad Manager. Nếu Ad Manager nhận được yêu cầu quảng cáo cho nội dung được đánh dấu là ĐÃ XOÁ, thì quảng cáo tự quảng bá hoặc quảng cáo được nhắm đến các đơn vị khoảng không quảng cáo hoặc tiêu chí nhắm mục tiêu khác vẫn có thể phân phát cho nội dung đó. Để chặn quảng cáo, hãy đặt trạng thái thành ĐÃ CHẶN.

VideoContentSyndicationInfo

Siêu dữ liệu để chỉ định mối quan hệ giữa nội dung chính tắc và nội dung tổng hợp.

Trường

Trường
Trường nhóm `syndication`. VideoContentSyndicationMetadata chỉ có thể chứa một trong những nội dung sau. `syndication` chỉ có thể là một trong những trạng thái sau:
`canonical_video_content`	`string` Tên của nội dung chuẩn. Giá trị này phải có định dạng "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" và phải thuộc cùng một mạng với nội dung chứa trường này.
`syndicated_video_content_names`	`SyndicatedVideoContentNames` Một bộ sưu tập nội dung tổng hợp

Trường nhóm syndication. VideoContentSyndicationMetadata chỉ có thể chứa một trong những nội dung sau. syndication chỉ có thể là một trong những trạng thái sau:

canonical_video_content

string

Tên của nội dung chuẩn. Giá trị này phải có định dạng "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}" và phải thuộc cùng một mạng với nội dung chứa trường này.

syndicated_video_content_names

SyndicatedVideoContentNames

Một bộ sưu tập nội dung tổng hợp

VideoFormat

Các định dạng mà nội dung video có thể được mã hoá.

Enum
`VIDEO_FORMAT_UNSPECIFIED`	Bạn chưa chỉ định định dạng video.
`HLS`	application/x-mpegURL
`DASH`	application/dash+xml

VideoIngestUrlInfo

Siêu dữ liệu chỉ định đường liên kết đến tệp m3u8 được dùng để điều chỉnh và tạo danh sách phát.

Trường

Trường
`video_format`	`VideoFormat` Định dạng của video.
`video_preconditioned`	`VideoPreconditioned` Để cho biết liệu nội dung có được điều chỉnh cho quảng cáo trong video hay không. Tức là các phân đoạn của bạn đã được chia nhỏ tại thời điểm chèn quảng cáo.
`url`	`string` Đường liên kết đến tệp m3u8.

video_format

VideoFormat

Định dạng của video.

video_preconditioned

VideoPreconditioned

Để cho biết liệu nội dung có được điều chỉnh cho quảng cáo trong video hay không. Tức là các phân đoạn của bạn đã được chia nhỏ tại thời điểm chèn quảng cáo.

url

string

Đường liên kết đến tệp m3u8.

VideoPreconditioned

Trạng thái điều chỉnh của nội dung video.

Enum
`NO`	Chưa được huấn luyện.
`YES`	Video đã được điều chỉnh/chia nhỏ.

Package google.ads.drx.video.v1 Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Chỉ mục

VideoContentIngestionService

ClosedCaptionFormat

ClosedCaptionUrlInfo

DynamicAdInsertionInfo

GracenoteMetadata

Metadata

SyndicatedVideoContentNames

UpdateVideoContentRequest

VideoContent

VideoContentStatus

VideoContentSyndicationInfo

VideoFormat

VideoIngestUrlInfo

VideoPreconditioned

Package google.ads.drx.video.v1