أنت تعرض المستندات القديمة لواجهة برمجة التطبيقات 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
عنصر التحسين المرتبط بالموضع. لا يتم استخدامها إلا عندما يكون نوع الموضع هو AFTER_ENRICHMENT_ITEM.
|
PositionType
المواضع المحتملة في الألبوم
| عمليات التعداد |
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 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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. |"]]
