בכל פריט חדש להזמנת שטחי פרסום צריך להצהיר אם הוא יציג מודעות פוליטיות באיחוד האירופי. העלאות של קובצי SDF ושל Display & Video 360 API שלא כוללות הצהרות ייכשלו. לפרטים נוספים אפשר לעיין בדף ההוצאות משימוש.
המזהה הוא בפורמט {exchange}-{legacyGuaranteedOrderId}
פרמטרים של שאילתה
פרמטרים
פרמטר של איחוד accessor. חובה.
מזהה את הישות ב-DV360 שבה מתבצעת הבקשה. בקשת ה-GET תחזיר רק הזמנה מובטחת שאפשר לגשת אליה בישות DV360 שזוהתה בתוך accessor. הערך accessor יכול להיות רק אחד מהבאים:
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-09-09 (שעון UTC)."],[[["\u003cp\u003eRetrieves a specific guaranteed order using its unique identifier, formatted as \u003ccode\u003e{exchange}-{legacyGuaranteedOrderId}\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eRequires specifying an \u003ccode\u003eaccessor\u003c/code\u003e in the query parameters to identify the DV360 entity (partner or advertiser) with access to the order.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should be empty, and a successful response returns a \u003ccode\u003eGuaranteedOrder\u003c/code\u003e object.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["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"],null,["| Display \\& Video 360 API v3 is deprecated and will sunset on **October 7, 2025** . Migrate to [Display \\& Video 360 API v4](/display-video/api/reference/rest/v4) before sunset to avoid an interruption in service.\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\nHTTP request\n\n`GET https://displayvideo.googleapis.com/v3/guaranteedOrders/{guaranteedOrderId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\nPath 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\nQuery 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\nRequest body\n\nThe request body must be empty.\n\nResponse body\n\nIf successful, the response body contains an instance of [GuaranteedOrder](/display-video/api/reference/rest/v3/guaranteedOrders#GuaranteedOrder).\n\nAuthorization 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](/identity/protocols/OAuth2)."]]
