Package google.ads.dai.v1

ดัชนี

PartnerDiscoveryService

จัดการการส่งผ่านข้อมูล DAI และการอัปโหลดครีเอทีฟโฆษณาไปยัง YouTube

CreateCreative

rpc CreateCreative(CreateCreativeRequest) returns (Operation)

สร้างครีเอทีฟโฆษณา แสดงครีเอทีฟโฆษณาในช่อง response เมื่อดำเนินการเสร็จสมบูรณ์ หรือ google.rpc.Code เมื่อดำเนินการไม่สำเร็จ แสดงผล CreateCreativeOperationMetadata รวมถึงสถานะการส่งผ่านข้อมูลในช่อง metadata
DeleteCreative

rpc DeleteCreative(DeleteCreativeRequest) returns (Empty)

ลบครีเอทีฟโฆษณา
GetCreative

rpc GetCreative(GetCreativeRequest) returns (Creative)

รับครีเอทีฟโฆษณา

CreateCreativeOperationMetadata

ข้อมูลเมตาสําหรับการดำเนินการที่ใช้เวลานานซึ่ง CreateCreative แสดงผล นำเสนอในชื่อ metadata

ช่อง
creative_url

string

URL ของครีเอทีฟโฆษณาที่ใช้สำหรับการนำเข้า นี่คือ URL ของ Mezzanine หรือ URL การแสดงผลสื่อที่เลือก ซึ่งเลือกตามพร็อพเพอร์ตี้ที่ระบุในคำขอ
gv_registry_id

string

ตัวระบุที่ไม่ซ้ำกันสำหรับครีเอทีฟโฆษณาวิดีโอ หากนำเข้าสําเร็จ ชื่อของแหล่งข้อมูลครีเอทีฟโฆษณาคือ creatives/gv_registry_id
create_time

Timestamp

เวลาที่สร้างคำขอนำเข้า
youtube_status

IngestionStatus

สถานะการส่งผ่านข้อมูล YouTube ปัจจุบัน

CreateCreativeRequest

คำขอสำหรับ PartnerDiscoveryService.CreateCreative

ช่อง
creative

Creative

ครีเอทีฟโฆษณาที่จะส่งผ่านข้อมูล
dynamic_creative_info

DynamicCreativeInfo

ข้อมูลเกี่ยวกับครีเอทีฟโฆษณาแบบไดนามิก ต้องระบุหากครีเอทีฟโฆษณาที่จะส่งผ่านเป็นแบบไดนามิก

ครีเอทีฟโฆษณา

แหล่งข้อมูลครีเอทีฟโฆษณา แสดงเป็น response เมื่อ PartnerDiscoveryService.CreateCreative เสร็จสมบูรณ์

ช่อง
name

string

เอาต์พุตเท่านั้น ชื่อที่ไม่ซ้ำ (รหัสวิดีโอของ Google) ของทรัพยากรครีเอทีฟโฆษณาในรูปแบบ creatives/id
advertiser

string

ชื่อผู้ลงโฆษณาที่แสดงในครีเอทีฟโฆษณานี้
ad_system

string

ต้องระบุ ชื่อของระบบโฆษณาที่สร้างคําขอนำเข้า
ad_title

string

ชื่อของโฆษณา
ad_description

string

คําอธิบายโฆษณา
mezzanines[]

MediaFile

URL ของไฟล์ Mezzanine ของโฆษณาและพร็อพเพอร์ตี้ของไฟล์ ต้องระบุ mezannines หรือ media_files อย่างน้อย 1 รายการ
media_files[]

MediaFile

URL ของไฟล์สื่อและพร็อพเพอร์ตี้ของโฆษณา ต้องระบุ mezannines หรือ media_files อย่างน้อย 1 รายการ
network_code

string

ไม่บังคับ รหัสเครือข่าย Google Ad Manager ของผู้เผยแพร่โฆษณาที่กําหนดให้แสดงครีเอทีฟโฆษณา ต้องระบุหากครีเอทีฟโฆษณาเป็นแบบไดนามิกและมี DynamicCreativeInfo ที่ป้อนข้อมูลไว้ใน CreateCreativeRequest

DeleteCreativeRequest

คำขอสำหรับ PartnerDiscoveryService.DeleteCreative

ช่อง
name

string

รหัสวิดีโอ Google ของครีเอทีฟโฆษณาที่จะลบ

DynamicCreativeInfo

ข้อมูลที่จําเป็นสําหรับครีเอทีฟโฆษณาแบบไดนามิกในการประมวลผล VCL

ช่อง
dynamic_group_id

string

รหัสที่แสดงโฆษณาวิดีโอหลักของครีเอทีฟโฆษณา ครีเอทีฟโฆษณาแบบไดนามิกทั้งหมดภายใต้รหัสกลุ่มแบบไดนามิกเดียวกันจะถือว่ามีเนื้อหาเดียวกัน แต่มีองค์ประกอบแบบไดนามิกที่แตกต่างกันในครีเอทีฟโฆษณา
active_duration

Duration

ระยะเวลาที่ครีเอทีฟโฆษณานี้ถือว่ามีการใช้งานอยู่ หลังจากเวลาดังกล่าว ระบบจะกำหนดเวลาการลบครีเอทีฟโฆษณาในที่เก็บครีเอทีฟโฆษณาวิดีโอ โดยระยะเวลาสูงสุดคือ 180 วัน หากไม่ได้ระบุข้อมูลในช่องนี้ ระบบจะใช้ระยะเวลาเริ่มต้น 30 วัน

FailureReason

สาเหตุที่ส่งผ่านข้อมูลครีเอทีฟโฆษณาไม่สําเร็จ

ช่อง
reason

Reason

คําอธิบายการนำเข้าครีเอทีฟโฆษณาที่ไม่สําเร็จ
code

int32

รหัสสถานะ HTTP ของการดำเนินการที่ไม่สำเร็จหากเหตุผลคือ DOWNLOAD_ERROR

เหตุผล

สาเหตุที่เป็นไปได้ของการนำเข้าครีเอทีฟโฆษณาไม่สำเร็จ

Enum
REASON_UNSPECIFIED ค่าเริ่มต้น
DOWNLOAD_ERROR ดาวน์โหลด HTTP ไม่สำเร็จ
INTERNAL_ERROR ข้อผิดพลาดภายใน
INVALID_MEDIA สื่อไม่ถูกต้อง

GetCreativeRequest

คำขอสำหรับ PartnerDiscoveryService.GetCreative

ช่อง
name

string

รหัสวิดีโอ Google ของครีเอทีฟโฆษณา

IngestionStatus

สถานะการส่งผ่านข้อมูลของคำขอสร้างครีเอทีฟโฆษณา

ช่อง
state

State

สถานะการส่งผ่านข้อมูลปัจจุบันของครีเอทีฟโฆษณาวิดีโอ
failure_reason

FailureReason

สาเหตุที่ส่งผ่านข้อมูลครีเอทีฟโฆษณาไม่สําเร็จ หากส่งผ่านข้อมูลไม่สําเร็จ
update_time

Timestamp

เวลาที่อัปเดตงานนำเข้าครั้งล่าสุด

รัฐ

สถานะการนำเข้า

Enum
STATE_UNSPECIFIED ค่าเริ่มต้น
PROCESSING ครีเอทีฟโฆษณาวิดีโอยังอยู่ระหว่างการประมวลผล
SUCCESS ประมวลผลครีเอทีฟโฆษณาวิดีโอเสร็จสมบูรณ์แล้ว
FAILURE นำเข้าครีเอทีฟโฆษณาวิดีโอไม่สำเร็จ โปรดดูที่ FailureReason

MediaFile

พร็อพเพอร์ตี้ที่เกี่ยวข้องกับไฟล์สื่อหนึ่งๆ

ช่อง
uri

string

ต้องระบุ URL ที่ไม่ซ้ำกันซึ่งไปยังไฟล์สื่อของครีเอทีฟโฆษณา
delivery

Delivery

ต้องระบุ ประเภทการแสดงครีเอทีฟโฆษณา
height

int32

ความสูงของไฟล์วิดีโอในหน่วยพิกเซล
width

int32

ความกว้างของไฟล์วิดีโอในหน่วยพิกเซล
mime_type

string

ต้องระบุ ประเภท MIME สำหรับคอนเทนเนอร์ไฟล์ ประเภท MIME ยอดนิยม ได้แก่ "video/x-flv" สำหรับวิดีโอ Flash และ "video/mp4" สำหรับ MP4
min_bitrate

int32

อัตราบิตต่ำสุดของไฟล์สื่อ สำหรับวิดีโอแบบโหลดแบบเป็นขั้นๆ ค่านี้ควรเป็นอัตราบิตเฉลี่ย
max_bitrate

int32

อัตราบิตสูงสุดของไฟล์สื่อ สำหรับวิดีโอแบบโหลดแบบเป็นขั้น ค่านี้ควรเป็นอัตราบิตเฉลี่ย

บริการจัดส่ง

ประเภทการแสดงโฆษณา

Enum
DELIVERY_UNSPECIFIED ค่าการแสดงผลเริ่มต้น
DELIVERY_PROGRESSIVE การส่งวิดีโอแบบโปรเกรสซีฟ
DELIVERY_STREAMING การส่งวิดีโอสตรีมมิง