2025년 9월 8일부터 모든 새 광고 항목은 유럽연합 (EU) 정치 광고를 게재할지 여부를 선언해야 합니다. 선언을 제공하지 않는 Display & Video 360 API 및 SDF 업로드는 실패합니다. 통합을 업데이트하여 이 선언을 하는 방법에 대한 자세한 내용은
지원 중단 페이지를 참고하세요.
REST Resource: advertisers.channels
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
리소스: 채널
단일 채널 채널은 관련 웹사이트 및 앱의 맞춤 그룹입니다.
| JSON 표현 |
{
"name": string,
"channelId": string,
"displayName": string,
"positivelyTargetedLineItemCount": string,
"negativelyTargetedLineItemCount": string,
// Union field owner can be only one of the following:
"partnerId": string,
"advertiserId": string
// End of list of possible types for union field owner.
} |
| 필드 |
name |
string
출력 전용입니다. 채널의 리소스 이름입니다.
|
channelId |
string (int64 format)
출력 전용입니다. 채널의 고유 ID입니다. 시스템에서 할당합니다.
|
displayName |
string
필수 항목입니다. 채널의 표시 이름입니다. UTF-8로 인코딩되어야 하며 최대 길이는 240바이트여야 합니다.
|
positivelyTargetedLineItemCount |
string (int64 format)
출력 전용입니다. 이 채널을 직접 타겟팅하는 광고 항목의 수입니다.
|
negativelyTargetedLineItemCount |
string (int64 format)
출력 전용입니다. 이 채널을 직접적으로 제외하도록 타겟팅하는 광고 항목의 수입니다.
|
통합 필드 owner. 채널을 소유한 DV360 항목을 식별합니다. 파트너 또는 광고주일 수 있습니다. owner은 다음 중 하나여야 합니다. |
partnerId |
string (int64 format)
채널을 소유한 파트너의 ID입니다.
|
advertiserId |
string (int64 format)
채널을 소유한 광고주의 ID입니다.
|
메서드 |
|
|
새 채널을 만듭니다. |
|
|
파트너 또는 광고주의 채널을 가져옵니다. |
|
|
파트너 또는 광고주의 채널을 표시합니다. |
|
|
채널을 업데이트합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eChannels are custom groupings of related websites and apps, allowing for targeted advertising.\u003c/p\u003e\n"],["\u003cp\u003eEach channel has a unique ID, display name, and is owned by either a partner or an advertiser.\u003c/p\u003e\n"],["\u003cp\u003eChannels can be positively or negatively targeted by line items, impacting ad delivery.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage channels through methods like creating, retrieving, listing, and updating them via the API.\u003c/p\u003e\n"]]],["Channels are custom groups of websites and apps, uniquely identified by a system-assigned `channelId`. Key properties include a `displayName` (max 240 bytes), and counts of positively and negatively targeted line items. Ownership is designated by either a `partnerId` or `advertiserId`. Actions include creating, retrieving (get), listing, and updating (patch) channels. Each channel also has an associated `name` used to define the channel's resource.\n"],null,["# REST Resource: advertisers.channels\n\n| Display \\& Video 360 API 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- [Resource: Channel](#Channel)\n - [JSON representation](#Channel.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Channel\n-----------------\n\nA single channel. Channels are custom groups of related websites and apps.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"channelId\": string, \"displayName\": string, \"positivelyTargetedLineItemCount\": string, \"negativelyTargetedLineItemCount\": string, // Union field `owner` can be only one of the following: \"partnerId\": string, \"advertiserId\": string // End of list of possible types for union field `owner`. } ``` |\n\n| Fields ||\n|-----------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. The resource name of the channel. |\n| `channelId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The unique ID of the channel. Assigned by the system. |\n| `displayName` | `string` Required. The display name of the channel. Must be UTF-8 encoded with a maximum length of 240 bytes. |\n| `positivelyTargetedLineItemCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. Number of line items that are directly targeting this channel positively. |\n| `negativelyTargetedLineItemCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. Number of line items that are directly targeting this channel negatively. |\n| Union field `owner`. Identifies the DV360 entity that owns the channel. It can be either a partner or an advertiser. `owner` 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 owns the channel. |\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the advertiser that owns the channel. |\n\n| Methods ------- ||\n|--------------------------------------------------------------------------------|---------------------------------------------|\n| ### [create](/display-video/api/reference/rest/v3/advertisers.channels/create) | Creates a new channel. |\n| ### [get](/display-video/api/reference/rest/v3/advertisers.channels/get) | Gets a channel for a partner or advertiser. |\n| ### [list](/display-video/api/reference/rest/v3/advertisers.channels/list) | Lists channels for a partner or advertiser. |\n| ### [patch](/display-video/api/reference/rest/v3/advertisers.channels/patch) | Updates a channel. |"]]
