ตั้งแต่วันที่
8 กันยายน 2025 เป็นต้นไป รายการโฆษณาใหม่ทุกรายการจะต้องประกาศว่าจะแสดงโฆษณาทางการเมืองในสหภาพยุโรป (EU) หรือไม่ การอัปโหลด API ของ Display & Video 360 และ SDF ที่ไม่ได้ระบุการประกาศจะล้มเหลว ดูรายละเอียดเพิ่มเติมเกี่ยวกับวิธีอัปเดตการผสานรวมเพื่อประกาศนี้ได้ที่
หน้าการเลิกใช้งาน
Method: inventorySourceGroups.list
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
แสดงรายการกลุ่มแหล่งที่มาของพื้นที่โฆษณาที่ผู้ใช้ปัจจุบันเข้าถึงได้
พารามิเตอร์ orderBy
จะกําหนดลําดับ
คำขอ HTTP
GET https://displayvideo.googleapis.com/v4/inventorySourceGroups
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์การค้นหา
พารามิเตอร์ |
pageSize |
integer
ขนาดหน้าที่ต้องการ ต้องอยู่ระหว่าง 1 ถึง 200 หากไม่ระบุ ระบบจะใช้ 100 เป็นค่าเริ่มต้น
|
pageToken |
string
โทเค็นที่ระบุหน้าผลการค้นหาที่เซิร์ฟเวอร์ควรแสดง โดยปกติแล้ว ค่านี้คือค่าของ nextPageToken ที่แสดงผลจากการเรียกใช้เมธอด ListInventorySources ก่อนหน้านี้ หากไม่ระบุ ระบบจะแสดงหน้าแรกของผลการค้นหา
|
orderBy |
string
ฟิลด์สำหรับจัดเรียงรายการ ค่าที่ยอมรับมีดังนี้
displayName (ค่าเริ่มต้น)
inventorySourceGroupId
ลำดับการจัดเรียงเริ่มต้นคือจากน้อยไปมาก หากต้องการระบุลําดับจากน้อยไปมากสําหรับช่องหนึ่งๆ ให้เพิ่มส่วนต่อท้าย "desc" ต่อท้ายชื่อช่อง เช่น displayName desc
|
filter |
string
อนุญาตให้กรองตามช่องกลุ่มแหล่งที่มาของพื้นที่โฆษณา ไวยากรณ์ที่รองรับ
- นิพจน์ตัวกรองประกอบด้วยข้อจํากัดอย่างน้อย 1 ข้อ
- คุณรวมข้อจํากัดเข้าด้วยกันได้โดยใช้โอเปอเรเตอร์ทางตรรกะ
OR
- ข้อจํากัดมีรูปแบบเป็น
{field} {operator} {value}
- ฟิลด์ทั้งหมดต้องใช้โอเปอเรเตอร์
EQUALS (=)
ฟิลด์ที่รองรับ
ความยาวของช่องนี้ไม่ควรเกิน 500 อักขระ ดูข้อมูลเพิ่มเติมได้ที่คู่มือกรองคำขอ LIST
|
พารามิเตอร์ Union accessor ต้องระบุ ระบุเอนทิตี DV360 ที่ใช้ส่งคําขอ คําขอ LIST จะแสดงเฉพาะเอนทิตีกลุ่มแหล่งที่มาของพื้นที่โฆษณาที่เอนทิตี DV360 ที่ระบุภายใน accessor สามารถเข้าถึงได้ accessor ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
partnerId |
string (int64 format)
รหัสของพาร์ทเนอร์ที่มีสิทธิ์เข้าถึงกลุ่มแหล่งที่มาของพื้นที่โฆษณา พาร์ทเนอร์จะเข้าถึงกลุ่มแหล่งที่มาของพื้นที่โฆษณาที่ผู้ลงโฆษณาเป็นเจ้าของไม่ได้
|
advertiserId |
string (int64 format)
รหัสของผู้ลงโฆษณาที่มีสิทธิ์เข้าถึงกลุ่มแหล่งที่มาของพื้นที่โฆษณา หากกลุ่มแหล่งที่มาของพื้นที่โฆษณาเป็นของพาร์ทเนอร์ จะมีเพียงผู้ลงโฆษณาที่แชร์กลุ่มด้วยเท่านั้นที่เข้าถึงกลุ่มได้
|
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
ข้อความตอบกลับสําหรับ InventorySourceGroupService.ListInventorySourceGroups
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
{
"inventorySourceGroups": [
{
object (InventorySourceGroup )
}
],
"nextPageToken": string
} |
ช่อง |
inventorySourceGroups[] |
object (InventorySourceGroup )
รายการกลุ่มแหล่งที่มาของพื้นที่โฆษณา รายการนี้จะหายไปหากไม่มีข้อมูล
|
nextPageToken |
string
โทเค็นสําหรับดึงข้อมูลหน้าถัดไปของผลการค้นหา ส่งค่านี้ในช่อง pageToken ในการเรียกใช้เมธอด inventorySourceGroups.list ครั้งถัดไปเพื่อดึงข้อมูลหน้าถัดไป
|
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/display-video
ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-25 UTC
[null,null,["อัปเดตล่าสุด 2025-07-25 UTC"],[],[],null,["# Method: inventorySourceGroups.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListInventorySourceGroupsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists inventory source groups that are accessible to the current user.\n\nThe order is defined by the [orderBy](/display-video/api/reference/rest/v4/inventorySourceGroups/list#body.QUERY_PARAMETERS.order_by) parameter.\n\n### HTTP request\n\n`GET https://displayvideo.googleapis.com/v4/inventorySourceGroups`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Requested page size. Must be between `1` and `200`. If unspecified will default to `100`. |\n| `pageToken` | `string` A token identifying a page of results the server should return. Typically, this is the value of [nextPageToken](/display-video/api/reference/rest/v4/inventorySourceGroups/list#body.ListInventorySourceGroupsResponse.FIELDS.next_page_token) returned from the previous call to `ListInventorySources` method. If not specified, the first page of results will be returned. |\n| `orderBy` | `string` Field by which to sort the list. Acceptable values are: - `displayName` (default) - `inventorySourceGroupId` The default sorting order is ascending. To specify descending order for a field, a suffix \"desc\" should be added to the field name. For example, `displayName desc`. |\n| `filter` | `string` Allows filtering by inventory source group fields. Supported syntax: - Filter expressions are made up of one or more restrictions. - Restrictions can be combined by the logical operator `OR`. - A restriction has the form of `{field} {operator} {value}`. - All fields must use the `EQUALS (=)` operator. Supported fields: - `inventorySourceGroupId` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information. |\n| Union parameter `accessor`. Required. Identifies which DV360 entity the request is being made within. The LIST request will only return the inventory source group entities that are 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 advertiser-owned inventory source groups. |\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\nResponse message for InventorySourceGroupService.ListInventorySourceGroups.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"inventorySourceGroups\": [ { object (/display-video/api/reference/rest/v4/inventorySourceGroups#InventorySourceGroup) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|---------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `inventorySourceGroups[]` | `object (`[InventorySourceGroup](/display-video/api/reference/rest/v4/inventorySourceGroups#InventorySourceGroup)`)` The list of inventory source groups. This list will be absent if empty. |\n| `nextPageToken` | `string` A token to retrieve the next page of results. Pass this value in the [pageToken](/display-video/api/reference/rest/v4/inventorySourceGroups/list#body.QUERY_PARAMETERS.page_token) field in the subsequent call to `inventorySourceGroups.list` method to retrieve the next page of results. |\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)."]]