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'는 표지 사진의 크기를 너비 2048px, 높이 1024px로 설정합니다.
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입니다. 앨범 소유자의 경우 항상 true입니다.
isOwned

boolean

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

boolean

사용자가 앨범에 참여할 수 있으면 true입니다.

SharedAlbumOptions

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

JSON 표현 
{
  "isCollaborative": boolean,
  "isCommentable": boolean
}
필드
isCollaborative

boolean

공유 앨범에서 공동작업자 (앨범에 참여한 사용자)가 미디어 항목을 추가하도록 허용하는 경우 true입니다. 기본값은 false입니다.
isCommentable

boolean

공유 앨범에서 공동작업자 (앨범에 참여한 사용자)가 앨범에 댓글을 추가할 수 있도록 허용하는 경우 true입니다. 기본값은 false입니다.

메서드

addEnrichment

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

batchAddMediaItems

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

batchRemoveMediaItems

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

create

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

get

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

list

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

patch

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

share

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

unshare

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