اعتبارًا من 8 سبتمبر 2025، يجب أن يحدّد كل عنصر جديد في الحملة ما إذا كان سيعرض إعلانات سياسية في الاتحاد الأوروبي أم لا. ستتعذّر عمليات تحميل واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" وملفات SDF التي لا تقدّم بيانات الإفصاح. يمكنك الاطّلاع على صفحة الإيقاف النهائي لمزيد من التفاصيل حول كيفية تعديل عملية الدمج لإجراء هذا البيان.
مطلوب. رقم تعريف الطلب المضمون الذي سيتم استرجاعه.
يكون رقم التعريف بالتنسيق {exchange}-{legacyGuaranteedOrderId}
مَعلمات طلب البحث
المعلمات
مَعلمة الاتحاد accessor مطلوب.
تحدّد هذه السمة عنصر "مساحة العرض والفيديو 360" الذي يتمّ تقديم الطلب ضمنه. لن يعرض طلب GET سوى الطلب المضمون الذي يمكن الوصول إليه من خلال عنصر "مساحة العرض والفيديو 360" المحدّد ضمن accessor. يمكن أن تكون accessor إحدى القيم التالية فقط:
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Display & Video 360 API v2 has been sunset and this documentation describes how to get a guaranteed order using the API.\u003c/p\u003e\n"],["\u003cp\u003eThe request must include a path parameter specifying the guaranteed order ID and a query parameter identifying the accessing DV360 entity (partner or advertiser).\u003c/p\u003e\n"],["\u003cp\u003eThe response will contain the details of the specified guaranteed order if the request is successful and authorized with the 'https://www.googleapis.com/auth/display-video' scope.\u003c/p\u003e\n"]]],[],null,["# Method: guaranteedOrders.get\n\n| Display \\& Video 360 API v2 has sunset.\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nGets a guaranteed order.\n\n### HTTP request\n\n`GET https://displayvideo.googleapis.com/v2/guaranteedOrders/{guaranteedOrderId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------------------|----------------------------------------------------------------------------------------------------------------------------|\n| `guaranteedOrderId` | `string` Required. The ID of the guaranteed order to fetch. The ID is of the format `{exchange}-{legacyGuaranteedOrderId}` |\n\n### Query parameters\n\n| Parameters ||\n|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Union parameter `accessor`. Required. Identifies which DV360 entity the request is being made within. The GET request will only return guaranteed order that is accessible to the DV360 entity identified within the `accessor`. `accessor` can be only one of the following: ||\n| `partnerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the partner that has access to the guaranteed order. |\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the advertiser that has access to the guaranteed order. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [GuaranteedOrder](/display-video/api/reference/rest/v2/guaranteedOrders#GuaranteedOrder).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/display-video`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]