REST Resource: albums

리소스: 앨범

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

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

ShareInfo

공유된 앨범에 관한 정보입니다. 이 정보는 내가 만든 앨범이 공유되어 있으며 공유 범위가 있는 경우에만 포함됩니다.

JSON 표현 
{
  "sharedAlbumOptions": {
    object (SharedAlbumOptions)
  },
  "shareableUrl": string,
  "shareToken": string,
  "isJoined": boolean,
  "isOwned": boolean,
  "isJoinable": boolean
}
입력란
sharedAlbumOptions

object (SharedAlbumOptions)

사용자가 공유 앨범에 미디어 항목을 추가하거나 댓글을 달 수 있는지 제어하는 옵션입니다.
shareableUrl

string

공유된 Google 포토 앨범 링크 링크가 있는 모든 사용자는 앨범의 콘텐츠를 볼 수 있으므로 주의해서 다뤄야 합니다.

shareableUrl 매개변수는 앨범의 링크 공유가 사용 설정된 경우에만 반환됩니다. 사용자가 이미 링크로 공유되지 않은 앨범에 참여한 경우 앨범의 productUrl를 사용해 앨범에 액세스할 수 있습니다.

소유자가 Google 포토 앱에서 링크 공유를 사용 중지하거나 앨범 공유가 취소된 경우 shareableUrl이 무효화됩니다.
shareToken

string

소유자가 아닌 사용자를 대신하여 공유 앨범에 참여하거나, 탈퇴하거나, 세부정보를 가져오는 데 사용되는 토큰입니다.

소유자가 Google 포토 앱에서 링크 공유를 사용 중지하거나 앨범 공유가 취소된 경우 shareToken이 무효화됩니다.
isJoined

boolean

사용자가 앨범에 가입된 경우 true입니다. 이는 앨범의 소유자에게만 해당됩니다.
isOwned

boolean

사용자가 앨범을 소유하고 있으면 true입니다.
isJoinable

boolean

사용자가 앨범에 참여할 수 있는 경우 true입니다.

SharedAlbumOptions

앨범 공유를 제어하는 옵션입니다.

JSON 표현 
{
  "isCollaborative": boolean,
  "isCommentable": boolean
}
입력란
isCollaborative

boolean

공유 앨범에서 공동작업자 (앨범에 참여한 사용자)가 미디어 항목을 추가할 수 있는 경우 true입니다. 기본값은 거짓입니다.
isCommentable

boolean

공유 앨범에서 공동작업자 (앨범에 가입한 사용자)가 앨범에 댓글을 추가할 수 있는 경우 true입니다. 기본값은 거짓입니다.

방법

addEnrichment

 정의된 앨범의 지정된 위치에 보강을 추가합니다.

batchAddMediaItems

 사용자의 Google 포토 라이브러리에 있는 하나 이상의 미디어 항목을 앨범에 추가합니다.

batchRemoveMediaItems

 지정된 앨범에서 하나 이상의 미디어 항목을 삭제합니다.

create

 사용자의 Google 포토 라이브러리에 앨범을 만듭니다.

get

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

list

 Google 포토 앱의 앨범 탭에서 사용자에게 표시되는 모든 앨범을 나열합니다.

patch

 지정된 id로 앨범을 업데이트합니다.

share

 앨범을 공유되었으며 다른 사용자가 액세스할 수 있는 것으로 표시합니다.

unshare

 이전에 공유한 앨범을 비공개로 표시합니다.