כדי לדון במוצרים שלנו ולתת עליהם משוב, אפשר להצטרף לערוץ הרשמי של Display & Video 360 API וקובצי נתונים מובנים ב-Discord בשרת של
קהילת הפרסום והמדידה של Google.
Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
Method: guaranteedOrders.patch
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
עדכון של הזמנה מובטחת קיימת. הפונקציה מחזירה את ההזמנה המעודכנת עם ההתחייבות להזמנה, אם הפעולה בוצעה בהצלחה.
בקשת HTTP
PATCH https://displayvideo.googleapis.com/v4/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 Overview.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[],["The Display & Video 360 API v4 (beta) allows updating existing guaranteed orders via a PATCH request. The request URL includes the guaranteed order ID as a path parameter. Required query parameters include `updateMask`, to specify fields for updating, and an `accessor` (`partnerId` or `advertiserId`). The request and response bodies use the `GuaranteedOrder` format. The API uses gRPC Transcoding, and requires OAuth scope `https://www.googleapis.com/auth/display-video`. The request returns the updated guaranteed order upon success.\n"]]