이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Acl: insert

요청

HTTP 요청

POST https://www.googleapis.com/calendar/v3/calendars/calendarId/acl

매개변수

매개변수 이름	값	설명
경로 매개변수
`calendarId`	`string`	캘린더 식별자입니다. 캘린더 ID를 검색하려면 calendarList.list 메서드를 호출합니다. 현재 로그인한 사용자의 기본 캘린더에 액세스하려면 '`primary`'을(를) 사용하세요. 있습니다.
선택적 쿼리 매개변수
`sendNotifications`	`boolean`	캘린더 공유 변경사항에 관한 알림을 전송할지 여부입니다. 선택사항입니다. 기본값은 True입니다.

승인

다음 범위를 사용하여 이 요청을 인증받아야 합니다.

범위
`https://www.googleapis.com/auth/calendar`

자세한 내용은 인증 및 승인 페이지를 참조하세요.

요청 본문

요청 본문에 다음 속성이 지정된 Acl 리소스를 제공합니다.

속성 이름	값	설명	참고
필수 속성
`role`	`string`	범위에 할당된 역할입니다. 가능한 값은 다음과 같습니다. '`none`' - 액세스를 제공하지 않습니다. '`freeBusyReader`' - 한가함/바쁨 정보에 대한 읽기 액세스 권한을 제공합니다. '`reader`' - 캘린더에 대한 읽기 액세스 권한을 제공합니다. 비공개 이벤트는 리더 액세스 권한이 있는 사용자에게 표시되지만 이벤트 세부정보는 숨겨집니다. '`writer`' - 캘린더에 대한 읽기 및 쓰기 액세스 권한을 제공합니다. 비공개 이벤트는 작성자 액세스 권한이 있는 사용자에게 표시되고 이벤트 세부정보가 표시됩니다. '`owner`' - 캘린더의 소유권을 제공합니다. 이 역할은 작성자 역할의 모든 권한과 함께 ACL을 확인하고 조작할 수 있는 추가 권한을 갖습니다.	쓰기 가능
`scope`	`object`	이 ACL 규칙에서 캘린더 액세스 권한을 부여하는 범위입니다.
`scope.type`	`string`	범위 유형입니다. 가능한 값은 다음과 같습니다. '`default`' - 공개 범위입니다. 기본값입니다. '`user`' - 범위를 단일 사용자로 제한합니다. '`group`' - 범위를 그룹으로 제한합니다. '`domain`' - 범위를 도메인으로 제한합니다. 참고: "`default`" 또는 공개 범위에 부여된 권한은 인증 여부에 관계없이 모든 사용자에게 적용됩니다.
선택적 속성
`scope.value`	`string`	범위 유형에 따른 사용자 또는 그룹의 이메일 주소 또는 도메인의 이름입니다. '`default`' 유형의 경우 생략됩니다.	쓰기 가능

응답

요청에 성공할 경우 이 메서드는 응답 본문에 Acl 리소스를 반환합니다.

예

참고: 이 메서드에 제공되는 코드 예시가 지원되는 모든 프로그래밍 언어를 나타내는 것은 아닙니다. 지원되는 언어 목록은 클라이언트 라이브러리 페이지를 참조하세요.

자바

Java 클라이언트 라이브러리를 사용합니다.

import com.google.api.services.calendar.Calendar;
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();

// Create access rule with associated scope
AclRule rule = new AclRule();
Scope scope = new Scope();
scope.setType("scopeType").setValue("scopeValue");
rule.setScope(scope).setRole("role");

// Insert new access rule
AclRule createdRule = service.acl().insert('primary', rule).execute();
System.out.println(createdRule.getId());

Python

Python 클라이언트 라이브러리를 사용합니다.

rule = {
    'scope': {
        'type': 'scopeType',
        'value': 'scopeEmail',
    },
    'role': 'role'
}

created_rule = service.acl().insert(calendarId='primary', body=rule).execute()

print created_rule['id']

PHP

PHP 클라이언트 라이브러리를 사용합니다.

$rule = new Google_Service_Calendar_AclRule();
$scope = new Google_Service_Calendar_AclRuleScope();

$scope->setType("scopeType");
$scope->setValue("scopeValue");
$rule->setScope($scope);
$rule->setRole("role");

$createdRule = $service->acl->insert('primary', $rule);
echo $createdRule->getId();

Ruby

Ruby 클라이언트 라이브러리 사용

rule = Google::Apis::CalendarV3::AclRule.new(
  scope: {
    type: 'scopeType',
    value: 'scopeEmail',
  },
  role: 'role'
)
result = client.insert_acl('primary', rule)
print result.id

사용해 보기

아래의 API 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.