REST Resource: videoContent.networks.sources.content

Tài nguyên: VideoContent

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

Biểu diễn dưới dạng 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)
  }
}
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 có chứa nội dung này.

content_source_id là ID nguồn nội dung trong Google Ad Manager mà nội dung này phải thuộc vào.

cms_content_id là ID nội dung CMS trong Google Ad Manager, được hình thành như một phần của yêu cầu quảng cáo để xác định quảng cáo nào 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

enum (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ẽ hoạt động.
title

string

Bắt buộc. Tiêu đề của nội dung.
updateTime

string (Timestamp format)

Bắt buộc. Lần sửa đổi nội dung gần đây nhất.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
publishTime

string (Timestamp format)

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à kết thúc.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
duration

string (Duration format)

Thời lượng của nội dung. Thời lượng được hỗ trợ ở mức mili giây.

Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng "s". Ví dụ: "3.5s".
cuePoints[]

string (Duration format)

Xác định các điểm dừng. Điểm dừng là các thời điểm mà quảng cáo có thể được chèn vào video. Điểm dừng được hỗ trợ xuống đến mức mili giây. Đây là trường bắt buộc nếu video có điểm chèn quảng cáo trong video.

Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng "s". Ví dụ: "3.5s".
thumbnailUrl

string

URL hình thu nhỏ của nội dung.
metadata

object (Metadata)

Xác định siêu dữ liệu tuỳ chỉnh của nội dung.
gracenoteMetadata

object (GracenoteMetadata)

Siêu dữ liệu liên quan đến Gracenote về nội dung.
syndicationMetadata

object (VideoContentSyndicationInfo)

Siêu dữ liệu của nội dung liên quan đến phân phối.
dynamicAdInsertionMetadata

object (DynamicAdInsertionInfo)

Siêu dữ liệu liên quan đến nội dung của tính năng Chèn quảng cáo động.

VideoContentStatus

Các lựa chọn 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 mục tiêu theo nội dung sẽ được phân phát.
BLOCKED Sẽ không có quảng cáo nào được phân phát trên nội dung này nếu trạng thái là BỊ CHẶN.
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 một nội dung được đánh dấu là BỊ XÓA, thì quảng cáo tự quảng bá hoặc quảng cáo được nhắm mục tiêu đến đơ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 dựa trên nội dung đó. Để chặn quảng cáo, hãy đặt trạng thái thành BỊ CHẶN.

Metadata

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

Biểu diễn dưới dạng JSON 
{
  "keyValues": {
    string: value,
    ...
  }
}
Trường
keyValues

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

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

GracenoteMetadata

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

Biểu diễn dưới dạng JSON 
{
  "gracenoteId": string,
  "gracenoteSeriesId": string
}
Trường
gracenoteId

string

Bắt buộc. Tham chiếu đến mã 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 trong loạt phim 2. "MV" - phim 3. "SP" – sự kiện thể thao
gracenoteSeriesId

string

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

VideoContentSyndicationInfo

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

Biểu diễn dưới dạng 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.
}
Trường
Trường kết hợp syndication. VideoContentSyndiationMetadata chỉ có thể chứa một trong các siêu dữ liệu sau. syndication chỉ có thể là một trong những trạng thái sau đây:
canonicalVideoContent

string

Tên của nội dung chính tắc. Tài sản 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.
syndicatedVideoContentNames

object (SyndicatedVideoContentNames)

Tập hợp nội dung được tổng hợp

SyndicatedVideoContentNames

Danh sách tên của tất cả nội dung được cung cấp.

Biểu diễn dưới dạng JSON 
{
  "syndicatedVideoContent": [
    string
  ]
}
Trường
syndicatedVideoContent[]

string

Trường lặp lại của tên của nội dung được cung cấp. Các URL 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.

DynamicAdInsertionInfo

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

Biểu diễn dưới dạng JSON 
{
  "videoIngestUrlInfo": {
    object (VideoIngestUrlInfo)
  },
  "mediaUpdateTime": string,
  "closedCaptionUrlInfo": [
    {
      object (ClosedCaptionUrlInfo)
    }
  ],
  "fwCaid": string
}
Trường
videoIngestUrlInfo

object (VideoIngestUrlInfo)

Đường liên kết đến tệp m3u8 chính dùng để điều chỉnh và tạo danh sách phát.
mediaUpdateTime

string (Timestamp format)

Thời gian sửa đổi lần gần đây nhất của tệp video đã tham chiếu trong videoIngestUrlInfo.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
closedCaptionUrlInfo[]

object (ClosedCaptionUrlInfo)

URL tới tệp phụ đề.
fwCaid

string

Mã tài sản tuỳ chỉnh FreeWheel được dùng để nhắm mục tiêu quảng cáo.

VideoIngestUrlInfo

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

Biểu diễn dưới dạng JSON 
{
  "videoFormat": enum (VideoFormat),
  "videoPreconditioned": enum (VideoPreconditioned),
  "url": string
}
Trường
videoFormat

enum (VideoFormat)

Định dạng của video.
videoPreconditioned

enum (VideoPreconditioned)

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

string

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

VideoFormat

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

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

VideoPreconditioned

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

Enum
NO Chưa được điều chỉnh.
YES Video đã được điều chỉnh/ghép nối.

ClosedCaptionUrlInfo

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

Biểu diễn dưới dạng JSON 
{
  "languageCode": string,
  "closedCaptionFormat": enum (ClosedCaptionFormat),
  "url": string
}
Trường
languageCode

string

Mã ngôn ngữ BCP-47 của IETF biểu thị ngôn ngữ của tệp phụ đề.
closedCaptionFormat

enum (ClosedCaptionFormat)

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

string

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

ClosedCaptionFormat

Các định dạng có thể chứa tệp phụ đề.

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

Phương thức

update

 API để tạo nội dung mới hoặc cập nhật siêu dữ liệu nếu nội dung đã tồn tại trong Ad Manager.