REST Resource: channels
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
리소스: 채널
리소스 변경사항을 감시하는 데 사용되는 알림 채널입니다.
JSON 표현 |
{
"params": {
string: string,
...
},
"payload": boolean,
"id": string,
"resourceId": string,
"resourceUri": string,
"token": string,
"expiration": string,
"type": string,
"address": string,
"kind": string
} |
필드 |
params |
map (key: string, value: string)
전송 채널 동작을 제어하는 추가 매개변수입니다. 선택사항입니다. "key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
|
payload |
boolean
페이로드가 필요한지 여부를 나타내는 불리언 값입니다. 선택사항입니다.
|
id |
string
이 채널을 식별하는 UUID 또는 유사한 고유 문자열입니다.
|
resourceId |
string
이 채널에서 감시 중인 리소스를 식별하는 불투명 ID입니다. 여러 API 버전에서 안정적입니다.
|
resourceUri |
string
감시 중인 리소스의 버전별 식별자입니다.
|
token |
string
이 채널을 통해 전송되는 각 알림과 함께 타겟 주소로 전송되는 임의의 문자열입니다. 선택사항입니다.
|
expiration |
string (int64 format)
알림 채널 만료 날짜 및 시간(밀리초 단위의 Unix 타임스탬프로 표현)입니다. 선택사항입니다.
|
type |
string
이 채널에 사용된 전송 메커니즘의 유형입니다. 유효한 값은 'web_hook' 또는 'webhook'입니다.
|
address |
string
이 채널의 알림이 전송되는 주소입니다.
|
kind |
string
api#channel 인 리소스의 변경사항을 감시하는 데 사용되는 알림 채널로 식별합니다.
|
메서드 |
|
이 채널을 통해 리소스 모니터링을 중지합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[],[],null,["# REST Resource: channels\n\n- [Resource: Channel](#Channel)\n - [JSON representation](#Channel.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Channel\n-----------------\n\nA notification channel used to watch for resource changes.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"params\": { string: string, ... }, \"payload\": boolean, \"id\": string, \"resourceId\": string, \"resourceUri\": string, \"token\": string, \"expiration\": string, \"type\": string, \"address\": string, \"kind\": string } ``` |\n\n| Fields ||\n|---------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `params` | `map (key: string, value: string)` Additional parameters controlling delivery channel behavior. Optional. An object containing a list of `\"key\": value` pairs. Example: `{ \"name\": \"wrench\", \"mass\": \"1.3kg\", \"count\": \"3\" }`. |\n| `payload` | `boolean` A Boolean value to indicate whether payload is wanted. Optional. |\n| `id` | `string` A UUID or similar unique string that identifies this channel. |\n| `resourceId` | `string` An opaque ID that identifies the resource being watched on this channel. Stable across different API versions. |\n| `resourceUri` | `string` A version-specific identifier for the watched resource. |\n| `token` | `string` An arbitrary string delivered to the target address with each notification delivered over this channel. Optional. |\n| `expiration` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Date and time of notification channel expiration, expressed as a Unix timestamp, in milliseconds. Optional. |\n| `type` | `string` The type of delivery mechanism used for this channel. Valid values are \"web_hook\" or \"webhook\". |\n| `address` | `string` The address where notifications are delivered for this channel. |\n| `kind` | `string` Identifies this as a notification channel used to watch for changes to a resource, which is `api#channel`. |\n\n| Methods ------- ||\n|------------------------------------------------------------------|------------------------------------------------|\n| ### [stop](/workspace/drive/api/reference/rest/v3/channels/stop) | Stops watching resources through this channel. |"]]