Skip to content

feat: add @libre.graph.motionPhoto facet to driveItem #36

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
dschmidt wants to merge 3 commits into
base: main
Choose a base branch
from
+35 −0
Open

feat: add @libre.graph.motionPhoto facet to driveItem #36

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
4ad511d
Enhance OpenAPI spec with Motion Photo attributes
dschmidt Apr 11, 2026
791d7e7
Add motionPhotoVideoSize to OpenAPI specification
dschmidt Apr 12, 2026
fb6c9b6
refactor: model Motion Photo as a standalone facet on driveItem
dschmidt Apr 21, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 35 additions & 0 deletions api/openapi-spec/v1.0.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4914,6 +4914,9 @@ components:
video:
description: Video metadata, if the item is a video. Read-only.
$ref: '#/components/schemas/video'
'@libre.graph.motionPhoto':
description: Motion Photo metadata, if the item is a Motion Photo. Read-only.
$ref: '#/components/schemas/motionPhoto'
'@client.synchronize':
description: Indicates if the item is synchronized with the underlying storage provider. Read-only.
type: boolean
Expand Down Expand Up @@ -5137,6 +5140,38 @@ components:
type: string
format: date-time
description: Represents the date and time the photo was taken. Read-only.
motionPhoto:
type: object
readOnly: true
description: |
Motion Photo metadata. A Motion Photo is a still image with a short video clip appended to
the end of the file. The presence of this facet on a driveItem indicates that the item is
a Motion Photo; absence indicates it is not.

Based on the Google Motion Photo format v1.0 specification:
https://developer.android.com/media/platform/motion-photo-format
properties:
version:
type: integer
format: int32
description: The file format version of the Motion Photo. Currently always 1. Read-only.
readOnly: true
presentationTimestampUs:
type: integer
format: int64
description: |
Presentation timestamp in microseconds of the video frame that corresponds to the still
image. A value of -1 indicates unspecified. If absent, readers should use a timestamp
near the middle of the video track. Read-only.
readOnly: true
videoSize:
type: integer
format: int64
description: |
Size in bytes of the embedded video portion of the file. The video is appended at the
end of the file, so clients can fetch it with a Range request:
`Range: bytes=<fileSize - videoSize>-`. Read-only.
readOnly: true
geoCoordinates:
type: object
readOnly: true
Expand Down