Events: quickAdd

간단한 텍스트 문자열을 기반으로 이벤트를 생성합니다. 지금 사용해 보거나 예를 참조하세요.

요청

HTTP 요청

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

매개변수

매개변수 이름 값 설명
경로 매개변수
calendarId string 캘린더 식별자입니다. 캘린더 ID를 검색하려면 calendarList.list 메서드를 호출합니다. 현재 로그인한 사용자의 기본 캘린더에 액세스하려면 'primary'을(를) 사용하세요. 있습니다.
필수 쿼리 매개변수
text string 생성할 이벤트를 설명하는 텍스트입니다.
선택적 쿼리 매개변수
sendNotifications boolean 지원 중단되었습니다. 대신 sendUpdates를 사용하세요.

이벤트 생성에 관한 알림을 전송할지 여부를 나타냅니다. 값을 false로 설정해도 일부 이메일은 계속 전송될 수 있습니다. 기본값은 false입니다.
sendUpdates string 새 일정 생성에 대한 알림을 받아야 하는 참석자

사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
    </ph>
  • "all": 알림이 모든 참석자에게 전송됩니다.
  • "externalOnly": Google Calendar를 사용하지 않는 참석자에게만 알림이 전송됩니다.
  • 'none': 알림이 전송되지 않습니다. 캘린더 이전 작업의 경우 Events.import 메서드를 대신 사용하는 것이 좋습니다.

승인

이 요청을 처리하려면 다음 범위 중 하나 이상의 승인이 필요합니다.

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

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

요청 본문

이 메소드를 사용할 때는 요청 본문을 제공하지 마세요.

응답

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

예

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

자바

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

import com.google.api.services.calendar.Calendar;
import com.google.api.services.calendar.model.Event;

// ...

// Initialize Calendar service with valid OAuth credentials
Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials)
    .setApplicationName("applicationName").build();

// Quick-add an event
String eventText = "Appointment at Somewhere on June 3rd 10am-10:25am";
Event createdEvent =
    service.events().quickAdd('primary').setText(eventText).execute();

System.out.println(createdEvent.getId());

Python

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

created_event = service.events().quickAdd(
    calendarId='primary',
    text='Appointment at Somewhere on June 3rd 10am-10:25am').execute()

print created_event['id']

PHP

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

$createdEvent = $service->events->quickAdd(
    'primary',
    'Appointment at Somewhere on June 3rd 10am-10:25am');

echo $createdEvent->getId();

Ruby

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

result = client.quick_add_event(
  'primary',
  'Appointment at Somewhere on June 3rd 10am-10:25am')
print result.id

사용해 보기

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