Bạn đang xem tài liệu cũ về API Thư viện Google Photos.
AlbumPosition
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.
Chỉ định vị trí trong một album.
| Biểu diễn dưới dạng JSON |
{
"position": enum (PositionType),
// Union field relative_item can be only one of the following:
"relativeMediaItemId": string,
"relativeEnrichmentItemId": string
// End of list of possible types for union field relative_item.
} |
| Trường |
position |
enum (PositionType)
Loại vị trí cho một mục nội dung đa phương tiện hoặc mục làm phong phú.
|
Trường kết hợp relative_item. Mục mà vị trí tương ứng. Bạn chỉ phải đặt thuộc tính này nếu sử dụng loại vị trí AFTER_MEDIA_ITEM hoặc AFTER_ENRICHMENT_ITEM. relative_item chỉ có thể là một trong những trạng thái sau đây: |
relativeMediaItemId |
string
Mục nội dung đa phương tiện tương ứng với vị trí. Chỉ được sử dụng khi loại vị trí là SAU_MEDIA_ITEM.
|
relativeEnrichmentItemId |
string
Mục làm phong phú mà vị trí tương ứng. Chỉ được sử dụng khi loại vị trí là SAU_ENMULTIMENT_ITEM.
|
PositionType
Các vị trí có thể có trong một album.
| Enum |
POSITION_TYPE_UNSPECIFIED |
Giá trị mặc định nếu bạn không đặt enum này. |
FIRST_IN_ALBUM |
Ở phần đầu của đĩa nhạc. |
LAST_IN_ALBUM |
Ở cuối album. |
AFTER_MEDIA_ITEM |
Sau một mục nội dung nghe nhìn. |
AFTER_ENRICHMENT_ITEM |
Sau một mục làm giàu. |
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\u003e\u003ccode\u003eAlbumPosition\u003c/code\u003e defines the position of media or enrichment items within an album using the \u003ccode\u003ePositionType\u003c/code\u003e enum.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ePositionType\u003c/code\u003e includes options for positioning items at the beginning, end, or relative to other media or enrichment items within the album.\u003c/p\u003e\n"],["\u003cp\u003eWhen specifying positions relative to other items, \u003ccode\u003erelativeMediaItemId\u003c/code\u003e or \u003ccode\u003erelativeEnrichmentItemId\u003c/code\u003e must be used depending on the item type.\u003c/p\u003e\n"]]],["The core content describes how to specify a position within an album using JSON. A position is defined by a `position` type, which can be `FIRST_IN_ALBUM`, `LAST_IN_ALBUM`, `AFTER_MEDIA_ITEM`, or `AFTER_ENRICHMENT_ITEM`. If the position is after an existing item, a `relative_item` union field, containing either `relativeMediaItemId` or `relativeEnrichmentItemId`, specifies that item's ID. `POSITION_TYPE_UNSPECIFIED` is used if position type is not specified.\n"],null,["# AlbumPosition\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [PositionType](#PositionType)\n\nSpecifies a position in an album.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"position\": enum (/photos/library/legacy/reference/rest/v1/AlbumPosition#PositionType), // Union field `relative_item` can be only one of the following: \"relativeMediaItemId\": string, \"relativeEnrichmentItemId\": string // End of list of possible types for union field `relative_item`. } ``` |\n\n| Fields ||\n|----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------|\n| `position` | `enum (`[PositionType](/photos/library/legacy/reference/rest/v1/AlbumPosition#PositionType)`)` Type of position, for a media or enrichment item. |\n| Union field `relative_item`. The item to which the position is relative to. This must be set only if using position type `AFTER_MEDIA_ITEM` or `AFTER_ENRICHMENT_ITEM`. `relative_item` can be only one of the following: ||\n| `relativeMediaItemId` | `string` The media item to which the position is relative to. Only used when position type is AFTER_MEDIA_ITEM. |\n| `relativeEnrichmentItemId` | `string` The enrichment item to which the position is relative to. Only used when position type is AFTER_ENRICHMENT_ITEM. |\n\nPositionType\n------------\n\nPossible positions in an album.\n\n| Enums ||\n|-----------------------------|---------------------------------------|\n| `POSITION_TYPE_UNSPECIFIED` | Default value if this enum isn't set. |\n| `FIRST_IN_ALBUM` | At the beginning of the album. |\n| `LAST_IN_ALBUM` | At the end of the album. |\n| `AFTER_MEDIA_ITEM` | After a media item. |\n| `AFTER_ENRICHMENT_ITEM` | After an enrichment item. |"]]
