Acl: watch
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
ACL 리소스의 변경사항을 확인합니다.
요청
HTTP 요청
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/acl/watch
매개변수
매개변수 이름 |
값 |
설명 |
경로 매개변수 |
calendarId |
string |
캘린더 식별자입니다. 캘린더 ID를 가져오려면 calendarList.list 메서드를 호출합니다. 현재 로그인한 사용자의 기본 캘린더에 액세스하려면 'primary ' 키워드를 사용하세요.
|
승인
이 요청에는 다음 범위 중 하나 이상에 대한 승인이 필요합니다.
범위 |
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.acls |
https://www.googleapis.com/auth/calendar.acls.readonly |
자세한 내용은 인증 및 승인 페이지를 참고하세요.
요청 본문
요청 본문에 다음과 같은 구조의 데이터를 제공합니다.
{
"id": string,
"token": string,
"type": string,
"address": string,
"params": {
"ttl": string
}
}
속성 이름 |
값 |
설명 |
참고 |
id |
string |
이 채널을 식별하는 UUID 또는 유사한 고유 문자열입니다. |
|
token |
string |
이 채널을 통해 전송되는 각 알림과 함께 대상 주소로 전송되는 임의의 문자열입니다. 선택사항입니다. |
|
type |
string |
이 채널에 사용되는 전송 메커니즘 유형입니다. 유효한 값은 'web_hook ' (또는 'webhook ')입니다. 두 값 모두 메시지를 전송하는 데 HTTP 요청이 사용되는 채널을 나타냅니다. |
|
address |
string |
이 채널의 알림이 전송되는 주소입니다. |
|
params |
object |
전송 채널 동작을 제어하는 추가 매개변수입니다. 선택사항입니다. |
|
params.ttl |
string |
알림 채널의 수명(초). 기본값은 604,800초입니다. |
|
응답
요청에 성공할 경우 이 메소드는 다음과 같은 구조의 응답 본문을 반환합니다.
{
"kind": "api#channel",
"id": string,
"resourceId": string,
"resourceUri": string,
"token": string,
"expiration": long
}
속성 이름 |
값 |
설명 |
참고 |
kind |
string |
리소스 변경사항을 감시하는 데 사용되는 알림 채널('api#channel ')로 식별합니다. |
|
id |
string |
이 채널을 식별하는 UUID 또는 유사한 고유 문자열입니다. |
|
resourceId |
string |
이 채널에서 감시 중인 리소스를 식별하는 불투명한 ID입니다. 다양한 API 버전에서 안정적입니다. |
|
resourceUri |
string |
감시 중인 리소스의 버전별 식별자입니다. |
|
token |
string |
이 채널을 통해 전송되는 각 알림과 함께 대상 주소로 전송되는 임의의 문자열입니다. 선택사항입니다. |
|
expiration |
long |
알림 채널 만료 날짜 및 시간으로, Unix 타임스탬프로 밀리초 단위로 표시됩니다. 선택사항입니다. |
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[],[],null,["# Acl: watch\n\n| **Note:** Requires [authorization](#auth).\n\nWatch for changes to ACL resources.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/calendar/v3/calendars/calendarId/acl/watch\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `calendarId` | `string` | Calendar identifier. To retrieve calendar IDs call the [calendarList.list](/workspace/calendar/api/v3/reference/calendarList/list) method. If you want to access the primary calendar of the currently logged in user, use the \"`primary`\" keyword. |\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes:\n\n| Scope |\n|----------------------------------------------------------|\n| `https://www.googleapis.com/auth/calendar` |\n| `https://www.googleapis.com/auth/calendar.acls` |\n| `https://www.googleapis.com/auth/calendar.acls.readonly` |\n\nFor more information, see the [authentication and authorization](/workspace/guides/configure-oauth-consent) page.\n\n### Request body\n\nIn the request body, supply data with the following structure:\n\n```carbon\n{\n \"id\": string,\n \"token\": string,\n \"type\": string,\n \"address\": string,\n \"params\": {\n \"ttl\": string\n }\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `id` | `string` | A UUID or similar unique string that identifies this channel. | |\n| `token` | `string` | An arbitrary string delivered to the target address with each notification delivered over this channel. Optional. | |\n| `type` | `string` | The type of delivery mechanism used for this channel. Valid values are \"`web_hook`\" (or \"`webhook`\"). Both values refer to a channel where Http requests are used to deliver messages. | |\n| `address` | `string` | The address where notifications are delivered for this channel. | |\n| `params` | `object` | Additional parameters controlling delivery channel behavior. Optional. | |\n| params.`ttl` | `string` | The time-to-live in seconds for the notification channel. Default is 604800 seconds. | |\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```text\n{\n \"kind\": \"api#channel\",\n \"id\": string,\n \"resourceId\": string,\n \"resourceUri\": string,\n \"token\": string,\n \"expiration\": long\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------|----------|-------------------------------------------------------------------------------------------------------------------|-------|\n| `kind` | `string` | Identifies this as a notification channel used to watch for changes to a resource, which is \"`api#channel`\". | |\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` | `long` | Date and time of notification channel expiration, expressed as a Unix timestamp, in milliseconds. Optional. | |"]]