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é entre les sessions 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).

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
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'un é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 API doit ajouter les paramètres spécifiés dans la documentation pour les développeurs à cette URL.

Par exemple, '=w2048-h1024' définira les dimensions d'un élément multimédia de type photo sur une largeur de 2 048 px et une hauteur de 1 024 px.
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 la caméra avec laquelle le contenu multimédia a été capturé.
cameraModel

string

Modèle de la caméra avec laquelle le contenu multimédia a été capturé.
Champ d'union metadata. Métadonnées du fichier multimédia spécifiques à son type. metadata ne peut être qu'un des éléments suivants :
photoMetadata

object (PhotoMetadata)

Métadonnées pour un type de contenu photo.
videoMetadata

object (VideoMetadata)

Métadonnées pour un type de contenu vidéo.

PhotoMetadata

Métadonnées spécifiques à une photo, comme l'ISO, la distance focale et le temps 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 d'ouverture 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)

Durée 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"

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 elle n'est pas encore lisible.
READY

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

Il est possible que vous ne puissiez pas télécharger une vidéo qui n'est pas à l'état READY.
FAILED Un problème est survenu et la vidéo n'a pas pu être traitée.

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.