מוצג לך תיעוד של הגרסה הקודמת של Google Photos Library API.
AlbumPosition
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
| ייצוג ב-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.
} |
| שדות |
position |
enum (PositionType)
סוג המיקום – לפריט מדיה או העשרה.
|
שדה האיחוד relative_item. הפריט שאליו המיקום הוא יחסי. צריך להגדיר את השדה הזה רק אם משתמשים בסוג המיקום AFTER_MEDIA_ITEM או AFTER_ENRICHMENT_ITEM. relative_item יכול להיות רק אחת מהאפשרויות הבאות: |
relativeMediaItemId |
string
פריט המדיה שאליו המיקום הוא יחסי. המאפיין הזה משמש רק כשסוג המיקום הוא AFTER_MEDIA_ITEM.
|
relativeEnrichmentItemId |
string
פריט ההעשרה שאליו המיקום הוא יחסי. בשימוש רק כאשר סוג המיקום הוא לאחר_ENRICHMENT_ITEM.
|
PositionType
| טיפוסים בני מנייה (enum) |
POSITION_TYPE_UNSPECIFIED |
ערך ברירת המחדל אם המאפיין הזה לא מוגדר. |
FIRST_IN_ALBUM |
בתחילת האלבום. |
LAST_IN_ALBUM |
בסוף האלבום. |
AFTER_MEDIA_ITEM |
אחרי פריט מדיה. |
AFTER_ENRICHMENT_ITEM |
אחרי פריט העשרה. |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 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. |"]]
