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은 있는 그대로 사용해서는 안 됩니다. 매개변수를 사용하기 전에 이 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

 앱에서 만든 모든 앨범을 나열합니다.

patch

 지정된 id로 앱에서 만든 앨범을 업데이트합니다.