Package google.ads.dai.v1

אינדקס

• PartnerDiscoveryService (ממשק)
• CreateCreativeOperationMetadata (הודעה)
• CreateCreativeRequest (הודעה)
• Creative (הודעה)
• DeleteCreativeRequest (הודעה)
• DynamicCreativeInfo (הודעה)
• FailureReason (הודעה)
• FailureReason.Reason (enum)
• GetCreativeRequest (הודעה)
• IngestionStatus (הודעה)
• IngestionStatus.State (enum)
• MediaFile (הודעה)
• MediaFile.Delivery (enum)

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 של שכבת הביניים או כתובת ה-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 של קובצי המזנין של המודעה והמאפיינים שלהם. צריך לציין לפחות אחד מהשדות mezannines או media_files.
media_files[]	MediaFile כתובות ה-URL של קובצי המדיה במודעה והמאפיינים שלהם. צריך לציין לפחות אחד מהשדות mezannines או media_files.
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 ואת 'video/mp4' עבור MP4.
min_bitrate	int32 הקצב המינימלי של העברת הנתונים בקובץ המדיה. בסרטונים עם טעינת נתונים פרוגרסיבית, הערך הזה צריך להיות קצב הנתונים הממוצע.
max_bitrate	int32 קצב הנתונים המקסימלי של קובץ המדיה. בסרטונים עם טעינת נתונים פרוגרסיבית, הערך הזה צריך להיות קצב הנתונים הממוצע.

משלוח

סוגי הצגת המודעות.

טיפוסים בני מנייה (enum)
DELIVERY_UNSPECIFIED	ערך ברירת המחדל של העברה.
DELIVERY_PROGRESSIVE	העברת וידאו פרוגרסיבית.
DELIVERY_STREAMING	העברת וידאו בסטרימינג.