您目前查看的是 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 相簿應用程式「共享」分頁中的所有共享相簿。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間: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. |"]]