自
2025 年 9 月 8 日起,每個新委刊項都必須聲明是否會放送歐盟政治廣告。如果透過 Display & Video 360 API 和 SDF 上傳的檔案未提供聲明,系統就會失敗。如要進一步瞭解如何更新整合服務以進行這項聲明,請參閱
淘汰項目頁面。
Method: inventorySourceGroups.get
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
HTTP 要求
GET https://displayvideo.googleapis.com/v4/inventorySourceGroups/{inventorySourceGroupId}
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
inventorySourceGroupId |
string (int64 format)
必要欄位。要擷取的廣告空間來源群組 ID。
|
查詢參數
參數 |
聯集參數 accessor 。必要欄位。指出要求是在哪個 DV360 實體中提出。只有在 accessor 中識別的 DV360 實體可存取時,GET 要求才會傳回廣告空間來源群組實體。accessor 只能是下列其中一個: |
partnerId |
string (int64 format)
可存取廣告空間來源群組的合作夥伴 ID。 合作夥伴無法存取廣告主擁有的廣告空間來源群組。
|
advertiserId |
string (int64 format)
可存取廣告空間來源群組的廣告主 ID。 如果商品目錄來源群組是夥伴擁有,只有與該群組明確共用的廣告主才能存取該群組。
|
回應主體
如果成功,回應主體會包含 InventorySourceGroup
的執行例項。
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/display-video
詳情請參閱 OAuth 2.0 Overview。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 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 inventory source groups via a `GET` request. The request URL requires the `inventorySourceGroupId` as a path parameter. The `accessor` is a required query parameter, specifying either a `partnerId` or `advertiserId` to identify the accessing entity. The request body must be empty. A successful response will contain an `InventorySourceGroup` instance. The API requires the `https://www.googleapis.com/auth/display-video` OAuth scope.\n"],null,["# Method: inventorySourceGroups.get\n\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 an inventory source group.\n\n### HTTP request\n\n`GET https://displayvideo.googleapis.com/v4/inventorySourceGroups/{inventorySourceGroupId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------------------------|----------------------------------------------------------------------------------------------------------------------------------------------|\n| `inventorySourceGroupId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the inventory source group to fetch. |\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 the inventory source group entity if it 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 inventory source group. A partner cannot access an advertiser-owned inventory source group. |\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the advertiser that has access to the inventory source group. If an inventory source group is partner-owned, only advertisers to which the group is explicitly shared can access the group. |\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 [InventorySourceGroup](/display-video/api/reference/rest/v4/inventorySourceGroups#InventorySourceGroup).\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](/identity/protocols/OAuth2)."]]