Google 포토 라이브러리 API의 기존 문서를 보고 계신 것입니다.
Photos Library API
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Google 포토의 사진, 동영상, 앨범 관리
서비스: photoslibrary.googleapis.com
서비스 엔드포인트
서비스 엔드포인트는 API 서비스의 네트워크 주소를 지정하는 기준 URL입니다. 하나의 서비스는 여러 서비스 엔드포인트를 포함할 수 있습니다. 이 서비스에는 다음 서비스 엔드포인트가 포함되고, 그 아래의 모든 URI가 이 서비스 엔드포인트와 관련됩니다.
https://photoslibrary.googleapis.com
| 메서드 |
addEnrichment |
POST /v1/albums/{albumId}:addEnrichment
정의된 앨범의 지정된 위치에 보강 항목을 추가합니다. |
batchAddMediaItems |
POST /v1/albums/{albumId}:batchAddMediaItems
사용자의 Google 포토 라이브러리에 있는 미디어 항목을 하나 이상 앨범에 추가합니다. |
batchRemoveMediaItems |
POST /v1/albums/{albumId}:batchRemoveMediaItems(
)
지정된 앨범에서 하나 이상의 미디어 항목을 삭제합니다. |
create |
POST /v1/albums(
)
사용자의 Google 포토 라이브러리에 앨범을 만듭니다. |
get |
GET /v1/albums/{albumId}(
)
지정된 albumId를 기준으로 앨범을 반환합니다. |
list |
GET /v1/albums
Google 포토 앱의 앨범 탭에 사용자에게 표시되는 모든 앨범을 나열합니다. |
patch |
PATCH /v1/albums/{album.id}(
)
지정된 id로 앨범을 업데이트합니다. |
share |
POST /v1/albums/{albumId}:share(
)
앨범을 다른 사용자가 액세스할 수 있는 공유됨으로 표시합니다. |
unshare |
POST /v1/albums/{albumId}:unshare(
)
이전에 공유한 앨범을 비공개로 표시합니다. |
| 메서드 |
get |
GET /v1/sharedAlbums/{shareToken}
지정된 shareToken를 기반으로 앨범을 반환합니다. |
join |
POST /v1/sharedAlbums:join(
)
Google 포토 사용자를 대신하여 공유 앨범에 참여합니다. |
leave |
POST /v1/sharedAlbums:leave(
)
Google 포토 사용자를 대신하여 이전에 참여한 공유 앨범에서 나갑니다. |
list |
GET /v1/sharedAlbums(
)
사용자 Google 포토 앱의 공유 탭에서 사용 가능한 모든 공유 앨범을 나열합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eThe Google Photos Library API allows developers to manage photos, videos, and albums programmatically using REST resources.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can create, update, and delete albums; add and remove media items; and share albums with others using specific endpoints.\u003c/p\u003e\n"],["\u003cp\u003eMedia items can be created, retrieved, updated, searched, and listed using the API, enabling comprehensive media management functionalities.\u003c/p\u003e\n"],["\u003cp\u003eShared albums can be retrieved, joined, and left using designated endpoints, providing functionalities for collaborative photo sharing experiences.\u003c/p\u003e\n"],["\u003cp\u003eAll API requests are relative to the base service endpoint: \u003ccode\u003ehttps://photoslibrary.googleapis.com\u003c/code\u003e.\u003c/p\u003e\n"]]],["This content details how to interact with Google Photos via its API, accessible at `https://photoslibrary.googleapis.com`. Actions include managing albums (creating, listing, getting, updating, adding/removing media, sharing, unsharing), and media items (creating, listing, getting, updating, searching). It also covers managing shared albums (getting, joining, leaving, listing). Each action corresponds to specific HTTP methods (POST, GET, PATCH) at defined endpoints.\n"],null,["# Photos Library API\n\nManage photos, videos, and albums in Google Photos\n\n- [REST Resource: v1.albums](#v1.albums)\n- [REST Resource: v1.mediaItems](#v1.mediaItems)\n- [REST Resource: v1.sharedAlbums](#v1.sharedAlbums)\n\nService: photoslibrary.googleapis.com\n-------------------------------------\n\n### Service endpoint\n\nA [service endpoint](https://cloud.google.com/apis/design/glossary#api_service_endpoint) is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:\n\n- `https://photoslibrary.googleapis.com`\n\nREST Resource: [v1.albums](/photos/library/legacy/reference/rest/v1/albums)\n---------------------------------------------------------------------------\n\n| Methods ||\n|------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------|\n| [addEnrichment](/photos/library/legacy/reference/rest/v1/albums/addEnrichment) | `POST /v1/albums/{albumId}:addEnrichment` Adds an enrichment at a specified position in a defined album. |\n| [batchAddMediaItems](/photos/library/legacy/reference/rest/v1/albums/batchAddMediaItems) | `POST /v1/albums/{albumId}:batchAddMediaItems` Adds one or more media items in a user's Google Photos library to an album. |\n| [batchRemoveMediaItems](/photos/library/legacy/reference/rest/v1/albums/batchRemoveMediaItems) | `POST /v1/albums/{albumId}:batchRemoveMediaItems` Removes one or more media items from a specified album. |\n| [create](/photos/library/legacy/reference/rest/v1/albums/create) | `POST /v1/albums` Creates an album in a user's Google Photos library. |\n| [get](/photos/library/legacy/reference/rest/v1/albums/get) | `GET /v1/albums/{albumId}` Returns the album based on the specified `albumId`. |\n| [list](/photos/library/legacy/reference/rest/v1/albums/list) | `GET /v1/albums` Lists all albums shown to a user in the Albums tab of the Google Photos app. |\n| [patch](/photos/library/legacy/reference/rest/v1/albums/patch) | `PATCH /v1/albums/{album.id}` Update the album with the specified `id`. |\n| [share](/photos/library/legacy/reference/rest/v1/albums/share) | `POST /v1/albums/{albumId}:share` Marks an album as shared and accessible to other users. |\n| [unshare](/photos/library/legacy/reference/rest/v1/albums/unshare) | `POST /v1/albums/{albumId}:unshare` Marks a previously shared album as private. |\n\nREST Resource: [v1.mediaItems](/photos/library/legacy/reference/rest/v1/mediaItems)\n-----------------------------------------------------------------------------------\n\n| Methods ||\n|--------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------|\n| [batchCreate](/photos/library/legacy/reference/rest/v1/mediaItems/batchCreate) | `POST /v1/mediaItems:batchCreate` Creates one or more media items in a user's Google Photos library. |\n| [batchGet](/photos/library/legacy/reference/rest/v1/mediaItems/batchGet) | `GET /v1/mediaItems:batchGet` Returns the list of media items for the specified media item identifiers. |\n| [get](/photos/library/legacy/reference/rest/v1/mediaItems/get) | `GET /v1/mediaItems/{mediaItemId}` Returns the media item for the specified media item identifier. |\n| [list](/photos/library/legacy/reference/rest/v1/mediaItems/list) | `GET /v1/mediaItems` List all media items from a user's Google Photos library. |\n| [patch](/photos/library/legacy/reference/rest/v1/mediaItems/patch) | `PATCH /v1/mediaItems/{mediaItem.id}` Update the media item with the specified `id`. |\n| [search](/photos/library/legacy/reference/rest/v1/mediaItems/search) | `POST /v1/mediaItems:search` Searches for media items in a user's Google Photos library. |\n\nREST Resource: [v1.sharedAlbums](/photos/library/legacy/reference/rest/v1/sharedAlbums)\n---------------------------------------------------------------------------------------\n\n| Methods ||\n|----------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------|\n| [get](/photos/library/legacy/reference/rest/v1/sharedAlbums/get) | `GET /v1/sharedAlbums/{shareToken}` Returns the album based on the specified `shareToken`. |\n| [join](/photos/library/legacy/reference/rest/v1/sharedAlbums/join) | `POST /v1/sharedAlbums:join` Joins a shared album on behalf of the Google Photos user. |\n| [leave](/photos/library/legacy/reference/rest/v1/sharedAlbums/leave) | `POST /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) | `GET /v1/sharedAlbums` Lists all shared albums available in the Sharing tab of the user's Google Photos app. |"]]
