Method: guaranteedOrders.get
طلب HTTP
GET https://displayvideo.googleapis.com/v3/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-02-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-02-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Retrieves a specific guaranteed order using its unique identifier, formatted as `{exchange}-{legacyGuaranteedOrderId}`."],["Requires specifying an `accessor` in the query parameters to identify the DV360 entity (partner or advertiser) with access to the order."],["The request body should be empty, and a successful response returns a `GuaranteedOrder` object."],["Authorization requires the `https://www.googleapis.com/auth/display-video` OAuth scope."]]],["This document details how to retrieve a guaranteed order using a GET request. The request URL structure includes `guaranteedOrderId` as a required path parameter, formatted as `{exchange}-{legacyGuaranteedOrderId}`. A required query parameter, `accessor`, specifies either a `partnerId` or `advertiserId` to define the DV360 entity. The request body must be empty. Upon success, the response body contains a `GuaranteedOrder` instance. Access requires the `https://www.googleapis.com/auth/display-video` authorization scope.\n"]]
