REST Resource: sharedAlbums

리소스: 앨범

Google 포토의 앨범 표현입니다. 앨범은 미디어 항목의 컨테이너입니다. 애플리케이션에서 앨범을 공유한 경우 앨범에 추가 shareInfo 속성이 포함됩니다.

JSON 표현
{
  "id": string,
  "title": string,
  "productUrl": string,
  "isWriteable": boolean,
  "shareInfo": {
    object (ShareInfo)
  },
  "mediaItemsCount": string,
  "coverPhotoBaseUrl": string,
  "coverPhotoMediaItemId": string
}
입력란
id

string

앨범의 식별자입니다. 세션 간에 이 앨범을 식별하는 데 사용할 수 있는 영구 식별자입니다.

title

string

Google 포토 계정에서 사용자에게 표시되는 앨범의 이름입니다. 이 문자열은 500자(영문 기준)를 초과할 수 없습니다.

productUrl

string

[출력 전용] 앨범의 Google 포토 URL입니다. 사용자가 이 링크에 액세스하려면 Google 포토 계정에 로그인해야 합니다.

isWriteable

boolean

[출력 전용] 이 앨범에 미디어 항목을 만들 수 있는 경우 true입니다. 이 필드는 부여된 범위 및 앨범의 권한을 기반으로 합니다. 범위가 변경되거나 앨범의 권한이 변경되면 이 필드가 업데이트됩니다.

shareInfo

object (ShareInfo)

[출력 전용] 공유 앨범과 관련된 정보입니다. 이 필드는 앨범이 공유 앨범이고 개발자가 앨범을 만들었으며 사용자가 photoslibrary.sharing 범위를 부여한 경우에만 채워집니다.

mediaItemsCount

string (int64 format)

[출력 전용] 앨범의 미디어 항목 수입니다.

coverPhotoBaseUrl

string

[출력 전용] 표지 사진의 바이트로 연결되는 URL입니다. 그대로 사용하면 안 됩니다. 사용하기 전에 이 URL에 매개변수를 추가해야 합니다. 지원되는 매개변수의 전체 목록을 보려면 개발자 문서를 참고하세요. 예를 들어 '=w2048-h1024'는 표지 사진의 크기를 너비 2048픽셀, 높이 1024픽셀로 설정합니다.

coverPhotoMediaItemId

string

표지 사진과 연결된 미디어 항목의 식별자입니다.

방법

get

지정된 shareToken를 기준으로 앨범을 반환합니다.

join

Google 포토 사용자를 대신하여 공유 앨범에 참여합니다.

leave

Google 포토 사용자를 대신하여 이전에 참여한 공유 앨범에서 탈퇴합니다.

list

사용자의 Google 포토 앱의 공유 탭에서 사용할 수 있는 모든 공유 앨범을 나열합니다.