Settings: list

인증된 사용자의 모든 사용자 설정을 반환합니다. 지금 사용해 보거나 예를 참조하세요.

요청

HTTP 요청

GET https://www.googleapis.com/calendar/v3/users/me/settings

매개변수

매개변수 이름 값 설명
쿼리 매개변수(선택사항)
maxResults integer 하나의 결과 페이지에 반환되는 항목의 최대 개수입니다. 기본적으로 값은 100개입니다. 페이지 크기는 250개 항목보다 클 수 없습니다. 선택사항.
pageToken string 표시할 결과 페이지를 지정하는 토큰입니다. 선택사항.
syncToken string 이전 목록 요청의 결과 마지막 페이지에 반환된 nextSyncToken 필드에서 가져온 토큰입니다. 그러면 이 목록 요청의 결과에 이후 변경된 항목만 포함됩니다.
syncToken가 만료되면 서버가 410 GONE 응답 코드로 응답하며, 클라이언트는 저장용량을 비우고 syncToken 없이 전체 동기화를 실행해야 합니다.
점진적 동기화에 대해 자세히 알아보세요.
선택사항입니다. 기본값은 모든 항목을 반환하는 것입니다.

확인할 내용

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

범위
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.settings.readonly

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

요청 본문

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

응답

요청에 성공할 경우 이 메소드는 다음과 같은 구조의 응답 본문을 반환합니다.

{
  "kind": "calendar#settings",
  "etag": etag,
  "nextPageToken": string,
  "nextSyncToken": string,
  "items": [
    settings Resource
  ]
}
속성 이름 값 설명 메모
kind string 컬렉션 유형('calendar#settings')
etag etag 컬렉션의 ETag
items[] list 사용자 설정 목록입니다.
nextPageToken string 이 결과의 다음 페이지에 액세스하는 데 사용되는 토큰입니다. 추가 결과가 없을 경우 생략됩니다. 이 경우 nextSyncToken이 제공됩니다.
nextSyncToken string 나중에 결과가 반환된 후 변경된 항목만 검색하는 데 사용되는 토큰입니다. 추가 결과가 제공되면 생략됩니다. 이 경우 nextPageToken이 제공됩니다.

예

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

자바

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

import com.google.api.services.calendar.Calendar;
import com.google.api.services.calendar.model.Setting;
import com.google.api.services.calendar.model.Settings;
// ...

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

// Iterate over all user settings
Settings settings = service.settings().list().execute();

for (Setting setting : settings.getItems()) {
  System.out.println(setting.getId() + ": " + setting.getValue());
}

Python

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

settings = service.settings().list().execute()

for setting in settings['items']:
  print '%s: %s' % (setting['id'], setting['value'])

PHP

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

$settings = $service->settings->listSettings();

foreach ($settings->getItems() as $setting) {
  echo $setting->getId() . ': ' . $setting->getValue();
}

Ruby

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

result = client.list_settings
result.items.each do |e|
  print e.id + ": " + e.value + "\n"
end

사용해 보기

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