# Photos Library API

Manage photos, videos, and albums in Google Photos

- [REST Resource: v1.albums](https://developers.google.com/photos/library/legacy/reference/rest#v1.albums)
- [REST Resource: v1.mediaItems](https://developers.google.com/photos/library/legacy/reference/rest#v1.mediaItems)
- [REST Resource: v1.sharedAlbums](https://developers.google.com/photos/library/legacy/reference/rest#v1.sharedAlbums)

## Service: photoslibrary.googleapis.com

### Service endpoint

A [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:

- `https://photoslibrary.googleapis.com`

## REST Resource: [v1.albums](https://developers.google.com/photos/library/legacy/reference/rest/v1/albums)

| Methods ||
|---|---|
| `https://developers.google.com/photos/library/legacy/reference/rest/v1/albums/addEnrichment` | `POST /v1/albums/{albumId}:addEnrichment` Adds an enrichment at a specified position in a defined album. |
| `https://developers.google.com/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. |
| `https://developers.google.com/photos/library/legacy/reference/rest/v1/albums/batchRemoveMediaItems` | `POST /v1/albums/{albumId}:batchRemoveMediaItems` Removes one or more media items from a specified album. |
| `https://developers.google.com/photos/library/legacy/reference/rest/v1/albums/create` | `POST /v1/albums` Creates an album in a user's Google Photos library. |
| `https://developers.google.com/photos/library/legacy/reference/rest/v1/albums/get` | `GET /v1/albums/{albumId}` Returns the album based on the specified `albumId`. |
| `https://developers.google.com/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. |
| `https://developers.google.com/photos/library/legacy/reference/rest/v1/albums/patch` | `PATCH /v1/albums/{album.id}` Update the album with the specified `id`. |
| `https://developers.google.com/photos/library/legacy/reference/rest/v1/albums/share` | `POST /v1/albums/{albumId}:share` Marks an album as shared and accessible to other users. |
| `https://developers.google.com/photos/library/legacy/reference/rest/v1/albums/unshare` | `POST /v1/albums/{albumId}:unshare` Marks a previously shared album as private. |

## REST Resource: [v1.mediaItems](https://developers.google.com/photos/library/legacy/reference/rest/v1/mediaItems)

| Methods ||
|---|---|
| `https://developers.google.com/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. |
| `https://developers.google.com/photos/library/legacy/reference/rest/v1/mediaItems/batchGet` | `GET /v1/mediaItems:batchGet` Returns the list of media items for the specified media item identifiers. |
| `https://developers.google.com/photos/library/legacy/reference/rest/v1/mediaItems/get` | `GET /v1/mediaItems/{mediaItemId}` Returns the media item for the specified media item identifier. |
| `https://developers.google.com/photos/library/legacy/reference/rest/v1/mediaItems/list` | `GET /v1/mediaItems` List all media items from a user's Google Photos library. |
| `https://developers.google.com/photos/library/legacy/reference/rest/v1/mediaItems/patch` | `PATCH /v1/mediaItems/{mediaItem.id}` Update the media item with the specified `id`. |
| `https://developers.google.com/photos/library/legacy/reference/rest/v1/mediaItems/search` | `POST /v1/mediaItems:search` Searches for media items in a user's Google Photos library. |

## REST Resource: [v1.sharedAlbums](https://developers.google.com/photos/library/legacy/reference/rest/v1/sharedAlbums)

| Methods ||
|---|---|
| `https://developers.google.com/photos/library/legacy/reference/rest/v1/sharedAlbums/get` | `GET /v1/sharedAlbums/{shareToken}` Returns the album based on the specified `shareToken`. |
| `https://developers.google.com/photos/library/legacy/reference/rest/v1/sharedAlbums/join` | `POST /v1/sharedAlbums:join` Joins a shared album on behalf of the Google Photos user. |
| `https://developers.google.com/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. |
| `https://developers.google.com/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. |