Method: guaranteedOrders.patch

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של 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.