캘린더의 액세스 제어 목록에 있는 규칙을 반환합니다. 지금 사용해 보거나 예를 참조하세요.
요청
HTTP 요청
GET https://www.googleapis.com/calendar/v3/calendars/calendarId/acl
매개변수
매개변수 이름 | 값 | 설명 |
---|---|---|
경로 매개변수 | ||
calendarId |
string |
캘린더 식별자입니다. 캘린더 ID를 검색하려면 calendarList.list 메서드를 호출합니다. 현재 로그인한 사용자의 기본 캘린더에 액세스하려면 'primary '을(를) 사용하세요. 있습니다.
|
선택적 쿼리 매개변수 | ||
maxResults |
integer |
결과 페이지 1개에서 반환되는 최대 항목 수입니다. 기본적으로 값은 100개 항목입니다. 페이지 크기는 250개 항목을 초과할 수 없습니다. 선택사항입니다. |
pageToken |
string |
반환할 결과 페이지를 지정하는 토큰입니다. 선택사항입니다. |
showDeleted |
boolean |
결과에 삭제된 ACL을 포함할지 여부입니다. 삭제된 ACL은 'none '과 같은 role 로 표시됩니다. syncToken 가 제공되면 삭제된 ACL이 항상 포함됩니다. 선택사항입니다. 기본값은 False입니다.
|
syncToken |
string |
이전 목록 요청의 결과 마지막 페이지에서 반환된 nextSyncToken 필드에서 가져온 토큰입니다. 이 목록 요청의 결과에는 그 이후에 변경된 항목만 포함됩니다. 이전 목록 요청 이후 삭제된 모든 항목은 항상 결과 집합에 속하며 showDeleted 를 False로 설정할 수 없습니다. syncToken 가 만료되면 서버는 410 GONE 응답 코드로 응답하며 클라이언트는 스토리지를 지우고 syncToken 없이 전체 동기화를 실행해야 합니다. 증분 동기화에 대해 자세히 알아보세요. 선택사항. 기본값은 모든 항목을 반환하는 것입니다. |
승인
다음 범위를 사용하여 이 요청을 인증받아야 합니다.
범위 |
---|
https://www.googleapis.com/auth/calendar |
자세한 내용은 인증 및 승인 페이지를 참조하세요.
요청 본문
이 메소드를 사용할 때는 요청 본문을 제공하지 마세요.
응답
요청에 성공할 경우 이 메소드는 다음과 같은 구조의 응답 본문을 반환합니다.
{ "kind": "calendar#acl", "etag": etag, "nextPageToken": string, "nextSyncToken": string, "items": [ acl Resource ] }
속성 이름 | 값 | 설명 | 참고 |
---|---|---|---|
kind |
string |
컬렉션의 유형('calendar#acl ')입니다. |
|
etag |
etag |
컬렉션의 ETag입니다. | |
nextPageToken |
string |
이 결과의 다음 페이지에 액세스하는 데 사용되는 토큰입니다. 추가 결과가 없으면 생략되며, 이 경우 nextSyncToken 가 제공됩니다. |
|
items[] |
list |
액세스 제어 목록의 규칙 목록입니다. | |
nextSyncToken |
string |
결과가 반환된 이후 변경된 항목만 검색하기 위해 이후 시점에 사용되는 토큰입니다. 추가 결과가 있으면 생략되며, 이 경우 nextPageToken 가 제공됩니다. |
예
참고: 이 메서드에 제공되는 코드 예시가 지원되는 모든 프로그래밍 언어를 나타내는 것은 아닙니다. 지원되는 언어 목록은 클라이언트 라이브러리 페이지를 참조하세요.
자바
Java 클라이언트 라이브러리를 사용합니다.
import com.google.api.services.calendar.Calendar; import com.google.api.services.calendar.model.Acl; import com.google.api.services.calendar.model.AclRule; // ... // Initialize Calendar service with valid OAuth credentials Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials) .setApplicationName("applicationName").build(); // Iterate over a list of access rules Acl acl = service.acl().list('primary').execute(); for (AclRule rule : acl.getItems()) { System.out.println(rule.getId() + ": " + rule.getRole()); }
Python
Python 클라이언트 라이브러리를 사용합니다.
acl = service.acl().list(calendarId='primary').execute() for rule in acl['items']: print '%s: %s' % (rule['id'], rule['role'])
PHP
PHP 클라이언트 라이브러리를 사용합니다.
$acl = $service->acl->listAcl('primary'); foreach ($acl->getItems() as $rule) { echo $rule->getId() . ': ' . $rule->getRole(); }
Ruby
result = client.list_acls('primary') result.items.each do |e| print e.id + ": " + e.role + "\n" end
사용해 보기
아래의 API 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.