您正在查看 Google Photos Library API 的旧版文档。
Photos Library API
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
管理 Google 相册中的照片、视频和影集
服务:photoslibrary.googleapis.com
服务端点
服务端点是指定 API 服务的网络地址的基本网址。一项服务可能有多个服务端点。此服务具有以下服务端点,下面的所有 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 相册应用“分享”标签页中提供的所有共享影集。 |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\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. |"]]