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 새 일정 생성에 대한 알림을 받아야 하는 참석자입니다.

허용되는 값은 다음과 같습니다.
  • 'all': 모든 참석자에게 알림이 전송됩니다.
  • 'externalOnly': Google Calendar를 사용하지 않는 참석자에게만 알림이 전송됩니다.
  • 'none': 알림이 전송되지 않습니다. 캘린더 이전 작업의 경우 대신 Events.import 메서드를 사용하는 것이 좋습니다.

승인

이 요청에는 다음 범위 중 하나 이상에 대한 승인이 필요합니다.

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

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

요청 본문

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

응답

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