REST Resource: mediaItems

Ressource: MediaItem

Représentation d'un élément multimédia (photo ou vidéo, par exemple) dans Google Photos.

Représentation JSON 
{
  "id": string,
  "description": string,
  "productUrl": string,
  "baseUrl": string,
  "mimeType": string,
  "mediaMetadata": {
    object (MediaMetadata)
  },
  "contributorInfo": {
    object (ContributorInfo)
  },
  "filename": string
}
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.
description

string

Description de l'élément multimédia. Cette information s'affiche dans la section d'informations de l'élément dans l'application Google Photos. Elle doit comporter moins de 1 000 caractères. N'incluez que du texte rédigé par les utilisateurs. Les descriptions doivent ajouter du contexte et aider les utilisateurs à comprendre les contenus multimédias. N'incluez pas de chaînes générées automatiquement, telles que des noms de fichiers, des balises et d'autres métadonnées.
productUrl

string

URL Google Photos de l'élément multimédia. Ce lien n'est disponible que pour les utilisateurs connectés. Lorsqu'elle est récupérée à partir d'une recherche d'album, l'URL pointe vers l'élément de l'album.
baseUrl

string

URL des octets de l'élément multimédia. Cette URL ne doit pas être utilisée telle quelle. Des paramètres doivent être ajoutés à cette URL avant de l'utiliser. Pour obtenir la liste complète des paramètres compatibles, consultez la documentation destinée aux 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 de l'élément multimédia. Par exemple, image/jpeg.
mediaMetadata

object (MediaMetadata)

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

object (ContributorInfo)

Informations sur l'utilisateur qui a ajouté cet élément multimédia. Notez que cette valeur n'est incluse que lorsque vous utilisez mediaItems.search avec l'ID d'un album partagé. L'album doit être créé par votre application et vous devez disposer du champ d'application de partage.
filename

string

Nom du fichier de l'élément multimédia. Cette information s'affiche dans la section d'informations de l'élément dans l'application Google Photos.

MediaMetadata

Métadonnées d'un élément multimédia.

Représentation JSON 
{
  "creationTime": string,
  "width": string,
  "height": string,

  // Union field metadata can be only one of the following:
  "photo": {
    object (Photo)
  },
  "video": {
    object (Video)
  }
  // End of list of possible types for union field metadata.
}
Champs
creationTime

string (Timestamp format)

Heure à laquelle l'élément multimédia a été créé pour la première fois (et non à laquelle il a été importé dans Google Photos).

Utilise la norme RFC 3339, où la sortie générée est toujours normalisée avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
width

string (int64 format)

Largeur d'origine (en pixels) de l'élément multimédia.
height

string (int64 format)

Hauteur d'origine (en pixels) de l'élément multimédia.
Champ d'union metadata. Métadonnées de l'élément multimédia spécifiques au type de contenu multimédia sous-jacent qu'il représente. metadata ne peut être qu'un des éléments suivants :
photo

object (Photo)

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

object (Video)

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

Photo

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

Représentation JSON 
{
  "cameraMake": string,
  "cameraModel": string,
  "focalLength": number,
  "apertureFNumber": number,
  "isoEquivalent": integer,
  "exposureTime": string
}
Champs
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.
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"

Vidéo

Métadonnées spécifiques à une vidéo, par exemple le nombre d'images par seconde et l'état du traitement. Certains de ces champs peuvent être nuls ou non inclus.

Représentation JSON 
{
  "cameraMake": string,
  "cameraModel": string,
  "fps": number,
  "status": enum (VideoProcessingStatus)
}
Champs
cameraMake

string

Marque de l'appareil photo avec lequel la vidéo a été prise.
cameraModel

string

Modèle de la caméra avec laquelle la vidéo a été prise.
fps

number

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

enum (VideoProcessingStatus)

État de traitement de la vidéo.

VideoProcessingStatus

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

Enums
UNSPECIFIED L'état du traitement de la vidéo est inconnu.
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é. Elle est maintenant prête à être visionnée. Important: Si la vidéo n'est pas prête, l'opération de téléchargement risque d'échouer.
FAILED Une erreur s'est produite et le traitement de la vidéo a échoué.

ContributorInfo

Informations sur l'utilisateur qui a ajouté l'élément multimédia. Notez que ces informations ne sont incluses que si l'élément multimédia se trouve dans un album partagé créé par votre application et que vous disposez de l'étendue de partage.

Représentation JSON 
{
  "profilePictureBaseUrl": string,
  "displayName": string
}
Champs
profilePictureBaseUrl

string

URL de la photo de profil du contributeur.
displayName

string

Nom à afficher du contributeur.

Méthodes

batchCreate

batchGet

get

list

patch

 Mettez à jour l'élément multimédia avec le id spécifié.