Package google.ads.dai.v1

Chỉ mục

• PartnerDiscoveryService (giao diện)
• CreateCreativeOperationMetadata (thông báo)
• CreateCreativeRequest (thông báo)
• Creative (thông báo)
• DeleteCreativeRequest (thông báo)
• DynamicCreativeInfo (thông báo)
• FailureReason (thông báo)
• FailureReason.Reason (enum)
• GetCreativeRequest (thông báo)
• IngestionStatus (thông báo)
• IngestionStatus.State (enum)
• MediaFile (thông báo)
• MediaFile.Delivery (enum)

PartnerDiscoveryService

Quản lý việc truyền dẫn DAI và tải mẫu quảng cáo lên YouTube.

CreateCreative
rpc CreateCreative(CreateCreativeRequest) returns (Operation) Tạo một Mẫu quảng cáo. Trả về một Mẫu quảng cáo trong trường response khi mẫu quảng cáo hoàn tất thành công hoặc google.rpc.Code khi không thành công. Trả về CreateCreativeOperationMetadata, bao gồm cả trạng thái truyền dẫn trong trường metadata.

DeleteCreative
rpc DeleteCreative(DeleteCreativeRequest) returns (Empty) Xoá một Mẫu quảng cáo.

GetCreative
rpc GetCreative(GetCreativeRequest) returns (Creative) Nhận mẫu quảng cáo.

CreateCreativeOperationMetadata

Siêu dữ liệu cho thao tác chạy trong thời gian dài do CreateCreative trả về. Trình bày dưới dạng metadata.

Trường
creative_url	string URL của mẫu quảng cáo được dùng để nhập. Đây là URL nội dung trung gian hoặc URL bản trình bày nội dung nghe nhìn được chọn, được chọn dựa trên các thuộc tính được cung cấp trong yêu cầu.
gv_registry_id	string Giá trị nhận dạng duy nhất của mẫu quảng cáo dạng video, nếu quá trình nhập thành công. Tên của tài nguyên Mẫu quảng cáo là creatives/gv_registry_id.
create_time	Timestamp Thời gian tạo yêu cầu truyền dẫn.
youtube_status	IngestionStatus Trạng thái truyền dẫn hiện tại trên YouTube.

CreateCreativeRequest

Yêu cầu đối với PartnerDiscoveryService.CreateCreative.

Trường
creative	Creative Mẫu quảng cáo cần nhập.
dynamic_creative_info	DynamicCreativeInfo Thông tin về mẫu quảng cáo động. Bắt buộc nếu mẫu quảng cáo cần nhập là mẫu quảng cáo động.

Tệp sáng tạo

Tài nguyên mẫu quảng cáo. Trình bày dưới dạng response khi hoàn tất PartnerDiscoveryService.CreateCreative.

Trường
name	string Chỉ có đầu ra. Tên riêng biệt (Mã video của Google) của tài nguyên Mẫu quảng cáo, ở định dạng creatives/id.
advertiser	string Tên của nhà quảng cáo xuất hiện trong mẫu quảng cáo này.
ad_system	string Bắt buộc. Tên của hệ thống quảng cáo tạo ra yêu cầu nhập.
ad_title	string Tiêu đề của quảng cáo.
ad_description	string Nội dung mô tả quảng cáo.
mezzanines[]	MediaFile URL tệp mezzanine của quảng cáo và các thuộc tính của tệp đó. Bạn phải cung cấp ít nhất một trong các thuộc tính mezannines hoặc media_files.
media_files[]	MediaFile URL của tệp nội dung nghe nhìn của quảng cáo và các thuộc tính của tệp đó. Bạn phải cung cấp ít nhất một trong các thuộc tính mezannines hoặc media_files.
network_code	string Không bắt buộc. Mã mạng Google Ad Manager của nhà xuất bản mà mẫu quảng cáo dành cho. Bắt buộc nếu mẫu quảng cáo là mẫu quảng cáo động và có DynamicCreativeInfo được điền sẵn trong CreateCreativeRequest.

DeleteCreativeRequest

Yêu cầu đối với PartnerDiscoveryService.DeleteCreative.

Trường
name	string Mã video trên Google của mẫu quảng cáo cần xoá.

DynamicCreativeInfo

Thông tin cần thiết để mẫu quảng cáo động thực hiện quá trình xử lý VCL.

Trường
dynamic_group_id	string Mã đại diện cho quảng cáo dạng video chính của mẫu quảng cáo. Tất cả mẫu quảng cáo động trong cùng một mã nhóm động có thể được coi là có cùng nội dung nhưng có các khía cạnh động khác nhau đối với mẫu quảng cáo.
active_duration	Duration Khoảng thời gian mẫu quảng cáo này được coi là đang hoạt động và được sử dụng. Sau khoảng thời gian này, mẫu quảng cáo sẽ được lên lịch xoá trong kho lưu trữ mẫu quảng cáo dạng video. Thời hạn sẽ được giới hạn ở mức 180 ngày. Nếu bạn không chỉ định trường này, thì thời lượng mặc định là 30 ngày sẽ được áp dụng.

FailureReason

Lý do không nhập được mẫu quảng cáo.

Trường
reason	Reason Nội dung mô tả lỗi truyền dẫn mẫu quảng cáo.
code	int32 Mã trạng thái HTTP không thành công nếu lý do là DOWNLOAD_ERROR.

Lý do

Những lý do có thể khiến quá trình nhập mẫu quảng cáo không thành công.

Enum
REASON_UNSPECIFIED	Giá trị mặc định.
DOWNLOAD_ERROR	Không tải được tệp xuống qua HTTP.
INTERNAL_ERROR	Lỗi nội bộ.
INVALID_MEDIA	Nội dung nghe nhìn không hợp lệ.

GetCreativeRequest

Yêu cầu đối với PartnerDiscoveryService.GetCreative.

Trường
name	string Mã video của Google cho mẫu quảng cáo.

IngestionStatus

Trạng thái nhập của yêu cầu Tạo mẫu quảng cáo.

Trường
state	State Trạng thái nhập hiện tại của mẫu quảng cáo dạng video.
failure_reason	FailureReason Lý do không nhập được mẫu quảng cáo, nếu không nhập được.
update_time	Timestamp Thời gian cập nhật gần đây nhất của công việc nhập.

Tiểu bang

Trạng thái nhập.

Enum
STATE_UNSPECIFIED	Giá trị mặc định.
PROCESSING	Mẫu quảng cáo dạng video vẫn đang được xử lý.
SUCCESS	Đã xử lý xong mẫu quảng cáo dạng video.
FAILURE	Không nhập được mẫu quảng cáo dạng video, hãy xem FailureReason.

MediaFile

Các thuộc tính liên quan đến một tệp phương tiện nhất định.

Trường
uri	string Bắt buộc. URL duy nhất đến tệp nội dung nghe nhìn của mẫu quảng cáo.
delivery	Delivery Bắt buộc. Loại phân phối của mẫu quảng cáo.
height	int32 Chiều cao gốc của tệp video, tính bằng pixel.
width	int32 Chiều rộng gốc của tệp video, tính bằng pixel.
mime_type	string Bắt buộc. Loại MIME cho vùng chứa tệp. Các loại MIME phổ biến bao gồm "video/x-flv" cho Flash Video và "video/mp4" cho MP4.
min_bitrate	int32 Tốc độ bit tối thiểu của tệp nội dung nghe nhìn. Đối với video tải dần, giá trị này phải là tốc độ bit trung bình.
max_bitrate	int32 Tốc độ bit tối đa của tệp phương tiện. Đối với video tải dần, giá trị này phải là tốc độ bit trung bình.

Giao hàng

Loại phân phối.

Enum
DELIVERY_UNSPECIFIED	Giá trị phân phối mặc định.
DELIVERY_PROGRESSIVE	Phân phối video theo từng phần.
DELIVERY_STREAMING	Phân phối video trực tuyến.