Google 포토 라이브러리 API의 기존 문서를 보고 계신 것입니다.
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은 있는 그대로 사용해서는 안 됩니다. 매개변수를 사용하기 전에 이 URL에 추가해야 합니다. 지원되는 매개변수의 전체 목록은 개발자 문서를 참조하세요. 예를 들어 '=w2048-h1024' 는 표지 사진의 크기를 너비 2048px, 높이 1024px로 설정합니다.
|
coverPhotoMediaItemId |
string
표지 사진과 연결된 미디어 항목의 식별자입니다.
|
메서드 |
|
지정된 shareToken 를 기준으로 앨범을 반환합니다. |
|
Google 포토 사용자를 대신하여 공유 앨범에 참여합니다. |
|
Google 포토 사용자를 대신하여 이전에 참여한 공유 앨범에서 탈퇴합니다. |
|
사용자 Google 포토 앱의 공유 탭에서 사용 가능한 모든 공유 앨범을 나열합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eAlbums in Google Photos are containers for media items and can be shared.\u003c/p\u003e\n"],["\u003cp\u003eShared albums have a \u003ccode\u003eshareInfo\u003c/code\u003e property and developers can access them with the \u003ccode\u003ephotoslibrary.sharing\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eAlbum\u003c/code\u003e resource provides methods to get, join, leave, and list shared albums.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eAlbum\u003c/code\u003e properties provide information such as ID, title, URL, writability status, media count, and cover photo details.\u003c/p\u003e\n"]]],["Albums in Google Photos are containers for media items, identified by a unique `id` and a user-facing `title`. Key details include the album's `productUrl`, whether it's `isWriteable`, `mediaItemsCount`, and cover photo information (`coverPhotoBaseUrl`, `coverPhotoMediaItemId`). Shared albums contain a `shareInfo` property. Actions include: retrieving albums with a `shareToken`, joining, leaving, and listing shared albums via methods such as `get`, `join`, `leave`, and `list`.\n"],null,["# REST Resource: sharedAlbums\n\n- [Resource: Album](#Album)\n - [JSON representation](#Album.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Album\n---------------\n\nRepresentation of an album in Google Photos. Albums are containers for media items. If an album has been shared by the application, it contains an extra `shareInfo` property.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"id\": string, \"title\": string, \"productUrl\": string, \"isWriteable\": boolean, \"shareInfo\": { object (/photos/library/legacy/reference/rest/v1/albums#Album.ShareInfo) }, \"mediaItemsCount\": string, \"coverPhotoBaseUrl\": string, \"coverPhotoMediaItemId\": string } ``` |\n\n| Fields ||\n|-------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `id` | `string` Identifier for the album. This is a persistent identifier that can be used between sessions to identify this album. |\n| `title` | `string` Name of the album displayed to the user in their Google Photos account. This string shouldn't be more than 500 characters. |\n| `productUrl` | `string` \\[Output only\\] Google Photos URL for the album. The user needs to be signed in to their Google Photos account to access this link. |\n| `isWriteable` | `boolean` \\[Output only\\] True if you can create media items in this album. This field is based on the scopes granted and permissions of the album. If the scopes are changed or permissions of the album are changed, this field is updated. |\n| `shareInfo` | `object (`[ShareInfo](/photos/library/legacy/reference/rest/v1/albums#Album.ShareInfo)`)` \\[Output only\\] Information related to shared albums. This field is only populated if the album is a shared album, the developer created the album and the user has granted the `photoslibrary.sharing` scope. |\n| `mediaItemsCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` \\[Output only\\] The number of media items in the album. |\n| `coverPhotoBaseUrl` | `string` \\[Output only\\] A URL to the cover photo's bytes. This shouldn't be used as is. Parameters should be appended to this URL before use. See the [developer documentation](https://developers.google.com/photos/library/guides/access-media-items#base-urls) for a complete list of supported parameters. For example, `'=w2048-h1024'` sets the dimensions of the cover photo to have a width of 2048 px and height of 1024 px. |\n| `coverPhotoMediaItemId` | `string` Identifier for the media item associated with the cover photo. |\n\n| Methods ------- ||\n|--------------------------------------------------------------------------|---------------------------------------------------------------------------------------|\n| ### [get](/photos/library/legacy/reference/rest/v1/sharedAlbums/get) | Returns the album based on the specified `shareToken`. |\n| ### [join](/photos/library/legacy/reference/rest/v1/sharedAlbums/join) | Joins a shared album on behalf of the Google Photos user. |\n| ### [leave](/photos/library/legacy/reference/rest/v1/sharedAlbums/leave) | Leaves a previously-joined shared album on behalf of the Google Photos user. |\n| ### [list](/photos/library/legacy/reference/rest/v1/sharedAlbums/list) | Lists all shared albums available in the Sharing tab of the user's Google Photos app. |"]]