يجب أن يوضّح كل عنصر جديد في "عناصر الحملة" ما إذا كان سيعرض إعلانات سياسية في الاتحاد الأوروبي أم لا. ستتعذّر عمليات تحميل واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" وملفات SDF التي لا تقدّم بيانات الإفصاح. يمكنك الاطّلاع على
صفحة الإيقاف نهائيًا لمزيد من التفاصيل.
Method: guaranteedOrders.get
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
طلب HTTP
GET https://displayvideo.googleapis.com/v4/guaranteedOrders/{guaranteedOrderId}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات |
guaranteedOrderId |
string
مطلوب. رقم تعريف الطلب المضمون الذي تريد استرجاعه. يجب أن يكون رقم التعريف بالتنسيق {exchange}-{legacyGuaranteedOrderId} .
|
مَعلمات طلب البحث
المعلمات |
مَعلمة الائتلاف accessor . مطلوب. لتحديد كيان "مساحة العرض والفيديو 360" الذي يتم تقديم الطلب من خلاله. لن يعرض طلب GET سوى الطلب المضمون الذي يمكن لجهة "مساحة العرض والفيديو 360" المحدّدة في accessor الوصول إليه. يمكن أن يكون 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 و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],["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"],null,[]]