Method: guaranteedOrders.patch

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

בקשת HTTP

PATCH https://displayvideo.googleapis.com/v1/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.