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'는 표지 사진의 크기를 너비 2048px, 높이 1024px로 설정합니다.

coverPhotoMediaItemId

string

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

메서드

get

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

join

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

leave

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

list

사용자 Google 포토 앱의 공유 탭에서 사용 가능한 모든 공유 앨범을 나열합니다.