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 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.