Method: guaranteedOrders.patch

עדכון של הזמנה מובטחת קיימת. הפונקציה מחזירה את ההזמנה המעודכנת עם ההתחייבות להזמנה, אם הפעולה בוצעה בהצלחה.

בקשת HTTP

PATCH https://displayvideo.googleapis.com/v3/guaranteedOrders/{guaranteedOrder.guaranteedOrderId}

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של נתיב

פרמטרים
guaranteedOrder.guaranteedOrderId

string

פלט בלבד. המזהה הייחודי של ההזמנה המובטחת. מספרי ההזמנות המבטיחים מופיעים בפורמט {exchange}-{legacyGuaranteedOrderId}.

פרמטרים של שאילתה

פרמטרים
updateMask

string (FieldMask format)

חובה. המסכה שמאפשרת לקבוע אילו שדות יעודכנו.

זוהי רשימה של שמות שדות מוגדרים במלואם, שמופרדים בפסיקים. דוגמה: "user.displayName,photo"

פרמטר האיחוד accessor. חובה.

מזהה את הישות ב-DV360 שבה הבקשה נשלחת. הערך של accessor יכול להיות רק אחת מהאפשרויות הבאות:
partnerId

string (int64 format)

המזהה של השותף שאליו מופנית הבקשה.
advertiserId

string (int64 format)

המזהה של המפרסם שממנו נשלחת הבקשה.

גוף הבקשה

גוף הבקשה מכיל מופע של GuaranteedOrder.

גוף התשובה

אם הפעולה מצליחה, גוף התגובה מכיל מופע של GuaranteedOrder.

היקפי הרשאה

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/display-video

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.