رابط برنامه‌نویسی کاربردی Display & Video 360 اکنون از مدیریت منابع Demand Gen پشتیبانی می‌کند. برای یادگیری نحوه ساخت و اجرای یک کمپین تبلیغاتی Demand Gen، به
راهنمای جدید ما مراجعه کنید.
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" . |
الزامی است. مشخص می‌کند که درخواست در کدام موجودیت DV360 انجام می‌شود. در زیر لیستی از فیلدهای ناسازگار آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم می‌شود: |
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 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2026-10-01 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2026-10-01 بهوقت ساعت هماهنگ جهانی."],[],["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"]]
