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 |
エンリッチメント アイテムの後。 |
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 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 a Google Photos album.\u003c/p\u003e\n"],["\u003cp\u003eIt offers five position types: \u003ccode\u003ePOSITION_TYPE_UNSPECIFIED\u003c/code\u003e, \u003ccode\u003eFIRST_IN_ALBUM\u003c/code\u003e, \u003ccode\u003eLAST_IN_ALBUM\u003c/code\u003e, \u003ccode\u003eAFTER_MEDIA_ITEM\u003c/code\u003e, and \u003ccode\u003eAFTER_ENRICHMENT_ITEM\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eFor positions relative to other items (\u003ccode\u003eAFTER_MEDIA_ITEM\u003c/code\u003e, \u003ccode\u003eAFTER_ENRICHMENT_ITEM\u003c/code\u003e), you must specify the ID of the relative media or enrichment item.\u003c/p\u003e\n"],["\u003cp\u003eThe JSON representation includes the \u003ccode\u003eposition\u003c/code\u003e type and, if necessary, the ID of the relative item (\u003ccode\u003erelativeMediaItemId\u003c/code\u003e or \u003ccode\u003erelativeEnrichmentItemId\u003c/code\u003e).\u003c/p\u003e\n"]]],["The content defines how to specify a position within an album using a JSON structure. It uses a `position` field with an enumerated type (`PositionType`) that can be `FIRST_IN_ALBUM`, `LAST_IN_ALBUM`, `AFTER_MEDIA_ITEM`, or `AFTER_ENRICHMENT_ITEM`. If positioning after an item, either `relativeMediaItemId` or `relativeEnrichmentItemId` must be specified in the `relative_item` union field to identify the referenced media or enrichment item.\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/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/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. |"]]