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에서 열 수 없습니다.

웹 기반 애플리케이션의 경우 이 URI에 /autoclose를 추가할 수 있습니다. 그러면 사용자가 선택을 완료한 후 '완료' 화면이 표시되는 대신 Google 포토 창 또는 탭이 자동으로 닫힙니다.
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

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