يتيح Display & Video 360 API الآن إدارة موارد "حملات زيادة الطلب". اطّلِع على
دليلنا الجديد للتعرّف على كيفية إنشاء حملة إعلانية لزيادة الطلب وتشغيلها.
تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.
Method: guaranteedOrders.get
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
طلب HTTP
GET https://displayvideo.googleapis.com/v4/guaranteedOrders/{guaranteedOrderId}
يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.
مَعلمات المسار
| المعلمات |
guaranteedOrderId |
string
الحقل مطلوب. رقم تعريف الطلب المضمون الذي سيتم استرجاعه. يكون رقم التعريف بالتنسيق {exchange}-{legacyGuaranteedOrderId}
|
مَعلمات طلب البحث
| المعلمات |
الحقل مطلوب. تحدّد هذه السمة العنصر في "مساحة العرض والفيديو 360" الذي يتمّ تقديم الطلب فيه. لن يعرض طلب استرداد بيانات باستخدام GET سوى الطلب المضمون الذي يمكن الوصول إليه من خلال كيان "مساحة العرض والفيديو 360" المحدّد في 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 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة 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"]]