REST Resource: mediaItems

Ressource: PickedMediaItem

Représentation d'une photo ou d'une vidéo sélectionnée par un 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é entre les sessions pour identifier cet élément multimédia.

createTime

string (Timestamp format)

Heure à laquelle l'élément multimédia a été créé (et non lors 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 qui constitue cet élément multimédia.

Type

Type d'élément multimédia.

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

MediaFile

Représentation d'un fichier individuel d'octets multimédias.

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

string

URL des octets du fichier multimédia.

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

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.

mediaFileMetadata

object (MediaFileMetadata)

Métadonnées associées au fichier multimédia, telles que la hauteur, la largeur ou l'heure de création.

MediaFileMetadata

Métadonnées relatives à 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 la photo a été prise.

cameraModel

string

Modèle de l'appareil photo avec lequel la photo a été prise.

Champ d'union metadata. Métadonnées du fichier multimédia spécifiques au type de contenu sous-jacent qu'il représente. metadata ne peut être qu'un des éléments suivants :
photoMetadata

object (PhotoMetadata)

Métadonnées d'un type de support photo.

videoMetadata

object (VideoMetadata)

Métadonnées d'un type de support vidéo.

PhotoMetadata

Métadonnées spécifiques à une photo, telles que l'ISO, la longueur focale et la durée d'exposition. Certains de ces champs peuvent être nuls ou non inclus.

Représentation JSON
{
  "focalLength": number,
  "apertureFNumber": number,
  "isoEquivalent": integer,
  "exposureTime": string,
  "printMetadata": {
    object (PrintMetadata)
  }
}
Champs
focalLength

number

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

apertureFNumber

number

Ouverture du diaphragme de l'objectif de l'appareil photo avec lequel la photo a été prise.

isoEquivalent

integer

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

exposureTime

string (Duration format)

Temps d'exposition de l'ouverture de l'appareil photo au moment où 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"

printMetadata

object (PrintMetadata)

Métadonnées associées à l'impression de la photo.

PrintMetadata

Métadonnées qui décrivent les propriétés d'impression d'une photo, par exemple le niveau de qualité de l'impression.

Représentation JSON
{
  "qualityScore": enum (Score)
}
Champs
qualityScore

enum (Score)

Niveau de qualité d'impression d'une photo, qui détermine si la photo est adaptée à l'impression.

Le score ne doit pas être utilisé pour conseiller aux utilisateurs de ne pas utiliser l'impression. Le score est défini sur HIGH si la photo est de haute qualité et que l'utilisateur souhaite l'imprimer. La note NORMAL indique que la photo n'est peut-être pas de haute qualité. SCORE_UNSPECIFIED indique qu'aucun score n'est disponible.

Score

Score qui décrit l'éligibilité d'une photo à l'impression.

Enums
SCORE_UNSPECIFIED Le score n'est pas spécifié par défaut.
HIGH La photo obtient un score élevé.
NORMAL Le score de la photo est normal.

VideoMetadata

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

Représentation JSON
{
  "fps": number
}
Champs
fps

number

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

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.