Bạn đang xem tài liệu cũ về API Thư viện Google Photos.
REST Resource: sharedAlbums
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tài nguyên: Đĩa nhạc
Hình ảnh đại diện cho một album trong Google Photos. Album là vùng chứa cho các mục nội dung nghe nhìn. Nếu ứng dụng đã chia sẻ một album, thì album đó sẽ chứa thêm một thuộc tính shareInfo
.
Biểu diễn dưới dạng JSON |
{
"id": string,
"title": string,
"productUrl": string,
"isWriteable": boolean,
"shareInfo": {
object (ShareInfo )
},
"mediaItemsCount": string,
"coverPhotoBaseUrl": string,
"coverPhotoMediaItemId": string
} |
Trường |
id |
string
Giá trị nhận dạng cho album. Đây là giá trị nhận dạng cố định có thể dùng giữa các phiên để xác định album này.
|
title |
string
Tên của album hiển thị cho người dùng trong tài khoản Google Photos của họ. Chuỗi này không được dài quá 500 ký tự.
|
productUrl |
string
[Chỉ đầu ra] URL trên Google Photos của album. Người dùng cần đăng nhập vào tài khoản Google Photos của họ để truy cập được đường liên kết này.
|
isWriteable |
boolean
[Chỉ có giá trị đầu ra] Đúng nếu bạn có thể tạo các mục nội dung nghe nhìn trong album này. Trường này dựa trên các phạm vi đã cấp và các quyền đối với album. Nếu phạm vi hoặc quyền của album thay đổi, trường này sẽ được cập nhật.
|
shareInfo |
object (ShareInfo )
[Chỉ có đầu ra] Thông tin liên quan đến album chia sẻ. Trường này chỉ được điền sẵn nếu album là album chia sẻ, nhà phát triển đã tạo album và người dùng đã cấp phạm vi photoslibrary.sharing .
|
mediaItemsCount |
string (int64 format)
[Chỉ có giá trị đầu ra] Số lượng mục nội dung nghe nhìn trong đĩa nhạc.
|
coverPhotoBaseUrl |
string
[Chỉ đầu ra] URL tới byte của ảnh bìa. Bạn không nên sử dụng nguyên trạng này. Bạn phải nối thông số vào URL này trước khi sử dụng. Hãy xem tài liệu dành cho nhà phát triển để biết danh sách đầy đủ các tham số được hỗ trợ. Ví dụ: '=w2048-h1024' đặt kích thước của ảnh bìa có chiều rộng là 2048 px và chiều cao là 1024 px.
|
coverPhotoMediaItemId |
string
Giá trị nhận dạng cho mục nội dung đa phương tiện được liên kết với ảnh bìa.
|
Phương thức |
|
Trả về đĩa nhạc dựa trên shareToken đã chỉ định. |
|
Tham gia một album chia sẻ thay mặt cho người dùng Google Photos. |
|
Rời khỏi một album chia sẻ đã tham gia trước đó thay mặt cho người dùng Google Photos. |
|
Liệt kê tất cả album được chia sẻ có trong thẻ Chia sẻ của ứng dụng Google Photos của người dùng. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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. |"]]