رابط برنامهنویسی کاربردی Display & Video 360 اکنون از مدیریت منابع Demand Gen پشتیبانی میکند. برای یادگیری نحوه ساخت و اجرای یک کمپین تبلیغاتی Demand Gen، به
راهنمای جدید ما مراجعه کنید.
Method: guaranteedOrders.get
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
سفارش تضمین شده دریافت میکند.
درخواست HTTP
GET https://displayvideo.googleapis.com/v4/guaranteedOrders/{guaranteedOrderId}
این URL از سینتکس Transcoding در gRPC استفاده میکند.
پارامترهای مسیر
| پارامترها |
|---|
guaranteedOrderId | string الزامی. شناسه سفارش تضمینشده برای دریافت. شناسه به فرمت {exchange}-{legacyGuaranteedOrderId} است. |
پارامترهای پرس و جو
| پارامترها |
|---|
الزامی است. مشخص میکند که درخواست در کدام موجودیت DV360 انجام میشود. درخواست GET فقط ترتیب تضمینشدهای را برمیگرداند که برای موجودیت DV360 شناساییشده در accessor قابل دسترسی باشد. در زیر لیستی از فیلدهای ناسازگار آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد: |
partnerId | string ( int64 format) شناسه شریکی که به سفارش تضمینشده دسترسی دارد. |
advertiserId | string ( int64 format) شناسهی تبلیغکنندهای که به سفارش تضمینشده دسترسی دارد. |
| پایان میدانهای ناسازگار. |
درخواست بدنه
بدنه درخواست باید خالی باشد.
بدنه پاسخ
در صورت موفقیت، بدنه پاسخ شامل نمونهای از 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, currently in beta, allows fetching a guaranteed order via a GET request. The request URL includes a required `guaranteedOrderId` path parameter and an `accessor` query parameter that identifies the DV360 entity (either `partnerId` or `advertiserId`) accessing the order. The request body must be empty. Successful requests return a `GuaranteedOrder` instance in the response body and use the scope of `https://www.googleapis.com/auth/display-video`.\n"]]