REST Resource: mediaItems

Ressource: PickedMediaItem

Représentation d'une photo ou d'une vidéo sélectionnée par l'utilisateur.

Représentation JSON
{
  "id": string,
  "createTime": string,
  "type": enum (Type),
  "mediaFile": {
    object (MediaFile)
  }
}
Champs
id

string

Identifiant de l'élément multimédia.

Il s'agit d'un identifiant persistant qui peut être utilisé d'une session à l'autre pour identifier cet élément multimédia.

createTime

string (Timestamp format)

Heure de création de l'élément multimédia (et non de son importation dans Google Photos).

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

type

enum (Type)

Type de cet élément multimédia.

mediaFile

object (MediaFile)

Fichier multimédia constituant cet élément multimédia.

Type

Type d'élément multimédia.

Enums
TYPE_UNSPECIFIED Le type n'est pas spécifié.
PHOTO L'élément multimédia représente une photo.
VIDEO L'élément multimédia représente une vidéo.

MediaFile

Représentation d'un fichier multimédia.

Représentation JSON
{
  "baseUrl": string,
  "mimeType": string,
  "filename": string,
  "mediaFileMetadata": {
    object (MediaFileMetadata)
  }
}
Champs
baseUrl

string

URL permettant de récupérer les octets du fichier multimédia.

Pour télécharger un fichier multimédia, le client de l'API doit ajouter les paramètres spécifiés dans la documentation destinée aux développeurs à cette URL.

Par exemple, '=w2048-h1024' définit les dimensions d'un élément multimédia de type photo sur une largeur de 2 048 pixels et une hauteur de 1 024 pixels.

mimeType

string

Type MIME du fichier multimédia. Par exemple, image/jpeg.

filename

string

Nom du fichier multimédia.

mediaFileMetadata

object (MediaFileMetadata)

Métadonnées associées au fichier multimédia, telles que la hauteur et la largeur.

MediaFileMetadata

Métadonnées d'un fichier multimédia.

Représentation JSON
{
  "width": integer,
  "height": integer,
  "cameraMake": string,
  "cameraModel": string,

  // Union field metadata can be only one of the following:
  "photoMetadata": {
    object (PhotoMetadata)
  },
  "videoMetadata": {
    object (VideoMetadata)
  }
  // End of list of possible types for union field metadata.
}
Champs
width

integer

Largeur d'origine (en pixels) du fichier multimédia.

height

integer

Hauteur d'origine (en pixels) du fichier multimédia.

cameraMake

string

Marque de l'appareil photo avec lequel le contenu multimédia a été capturé.

cameraModel

string

Modèle de l'appareil photo avec lequel le contenu multimédia a été capturé.

Champ d'union metadata. Métadonnées du fichier multimédia spécifiques à son type de contenu. metadata ne peut être qu'un des éléments suivants :
photoMetadata

object (PhotoMetadata)

Métadonnées d'un type de contenu multimédia photo.

videoMetadata

object (VideoMetadata)

Métadonnées d'un type de contenu multimédia vidéo.

PhotoMetadata

Métadonnées spécifiques à une photo, telles que la sensibilité ISO, la longueur focale et la durée d'exposition.

Il est possible que certains de ces champs ne soient pas définis.

Représentation JSON
{
  "focalLength": number,
  "apertureFNumber": number,
  "isoEquivalent": integer,
  "exposureTime": string
}
Champs
focalLength

number

Longueur focale de l'objectif de l'appareil photo avec lequel la photo a été prise.

apertureFNumber

number

Nombre f de l'objectif de l'appareil photo avec lequel la photo a été prise.

isoEquivalent

integer

Valeur ISO de l'appareil photo avec lequel la photo a été prise.

exposureTime

string (Duration format)

Durée d'exposition de l'ouverture de l'appareil photo lorsque la photo a été prise.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

VideoMetadata

Métadonnées spécifiques à une vidéo. (par exemple, fps).

Représentation JSON
{
  "fps": number,
  "processingStatus": enum (VideoProcessingStatus)
}
Champs
fps

number

Fréquence d'images de la vidéo.

processingStatus

enum (VideoProcessingStatus)

État de traitement de la vidéo.

VideoProcessingStatus

État de traitement d'une vidéo stockée dans Google Photos.

Enums
UNSPECIFIED L'état du traitement de la vidéo n'est pas spécifié.
PROCESSING

La vidéo est en cours de traitement.

L'utilisateur voit une icône pour cette vidéo dans l'application Google Photos, mais il ne peut pas encore la lire.

READY

Le traitement de la vidéo est terminé. Vous pouvez la regarder.

La tentative de téléchargement d'une vidéo qui n'est pas dans l'état READY peut échouer.

FAILED Une erreur s'est produite et le traitement de la vidéo a échoué.

Méthodes

list

Renvoie la liste des éléments multimédias sélectionnés par l'utilisateur au cours de la session spécifiée.