REST Resource: sessions

리소스: PickingSession

사용자가 Google 포토를 사용하여 사진과 동영상을 선택할 수 있는 사용자 세션을 나타냅니다.

JSON 표현 
{
  "id": string,
  "pickerUri": string,
  "pollingConfig": {
    object (PollingConfig)
  },
  "expireTime": string,
  "pickingConfig": {
    object (PickingConfig)
  },
  "mediaItemsSet": boolean
}
필드
id

string

출력 전용입니다. 이 세션에 대해 Google에서 생성한 식별자입니다.
pickerUri

string

출력 전용입니다. 사용자가 현재 세션의 사진과 동영상을 선택할 수 있도록 웹의 Google 포토로 리디렉션하는 데 사용되는 URI입니다.

이 페이지를 보려면 사용자가 웹브라우저에서 이 세션을 소유한 Google 계정에 로그인해야 합니다.

보안상의 이유로 pickerUri를 iframe에서 열 수 없습니다.
pollingConfig

object (PollingConfig)

출력 전용입니다. 애플리케이션이 sessions.get를 폴링하는 동안 사용해야 하는 권장 구성입니다.

이 필드는 이 세션에 아직 미디어 항목이 선택되지 않은 경우에만 채워집니다 (즉, mediaItemsSet는 false입니다.
expireTime

string (Timestamp format)

출력 전용입니다. 이 세션 (및 선택한 미디어 항목)에 대한 액세스 권한이 만료되는 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
pickingConfig

object (PickingConfig)

선택사항입니다. 이 세션 동안 사용자의 선택 환경을 위한 사진 선택 구성입니다.

이는 sessions.create를 호출할 때 클라이언트 애플리케이션에서 지정하며, 새 세션을 만들지 않고는 나중에 수정할 수 없습니다.
mediaItemsSet

boolean

출력 전용입니다. true로 설정된 경우 이 세션에 미디어 항목이 선택되었으며 애플리케이션은 mediaItems.list를 통해 선택된 미디어 항목 목록을 요청할 수 있습니다.

PollingConfig

API 폴링 구성

JSON 표현 
{
  "pollInterval": string,
  "timeoutIn": string
}
필드
pollInterval

string (Duration format)

출력 전용입니다. 폴링 요청 간의 권장 시간입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
timeoutIn

string (Duration format)

출력 전용입니다. 클라이언트가 폴링을 중지해야 하는 시간입니다.

값이 0이면 클라이언트가 아직 폴링을 중지하지 않은 경우 중지해야 함을 나타냅니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

PickingConfig

이 세션 동안 사용자의 선택 환경에 관한 클라이언트 지정 구성입니다.

JSON 표현 
{
  "maxItemCount": string
}
필드
maxItemCount

string (int64 format)

선택사항입니다. 사용자가 이 세션 중에 선택할 수 있는 최대 항목 수입니다. 지정하지 않을 경우 기본값은 2000입니다.

지정하지 않거나 0으로 설정하면 최대 2, 000개의 항목을 선택할 수 있습니다. 2,000을 초과하는 값은 2,000으로 변환됩니다. 음수 값을 사용하면 INVALID_ARGUMENT 오류가 발생합니다.

메서드

create

 사용자가 서드 파티 액세스를 위해 사진 및 동영상을 선택할 수 있는 새 세션을 생성합니다.

delete

 지정된 세션을 삭제합니다.

get

 지정된 세션에 대한 정보를 가져옵니다.