REST Resource: mediaItems

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Ressource: MediaItem

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

description

string

Description de l'élément multimédia. Cet élément s'affiche dans la section des informations de l'élément de l'application Google Photos. Il doit comporter moins de 1 000 caractères. Incluez uniquement le texte écrit par les utilisateurs. Les descriptions doivent fournir davantage de contexte et aider les utilisateurs à comprendre les médias. N'incluez aucune chaîne générée automatiquement, comme un nom de fichier, des tags ou d'autres métadonnées.

productUrl

string

URL Google Photos de l'élément multimédia. Ce lien est accessible à l'utilisateur uniquement s'il est connecté. Lorsque cette option est extraite d'une recherche d'album, l'URL pointe vers l'élément qu'il contient.

baseUrl

string

URL des octets de l'élément multimédia. Il ne doit pas être utilisé tel quel. Vous devez ajouter les paramètres à cette URL avant de l'utiliser. Consultez la documentation destinée aux développeurs pour obtenir la liste complète des paramètres acceptés. Par exemple, '=w2048-h1024' définit les dimensions d'un élément multimédia de type photo avec une largeur de 2 048 px et une hauteur de 1 024 px.

mimeType

string

Type MIME de l'élément multimédia. 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 avoir la portée de partage.

filename

string

Nom de fichier de l'élément multimédia. Ces informations sont présentées à l'utilisateur dans la section "Infos" de 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éé (et non lors de son importation dans Google Photos).

Horodatage au format RFC3339 UTC "Zulu" avec une résolution de nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

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 propres au type de contenu sous-jacent qu'il représente. metadata ne peut être qu'un des éléments suivants :
photo

object (Photo)

Métadonnées pour un type de support photo.

video

object (Video)

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

Photo

Métadonnées spécifiques à une photo, telles que ISO, durée focale et temps 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

Ouverture du champ 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 lors de la prise de vue.

Durée en secondes avec neuf chiffres au maximum après la virgule. Se termine par "s". Example : "3.5s".

Vidéo

Métadonnées spécifiques à une vidéo (par exemple, FPS ou état de 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 la caméra avec laquelle 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 du traitement de la vidéo.

État du traitement de la vidéo

État du traitement d'une vidéo en cours d'importation dans Google Photos.

Enums
UNSPECIFIED L'état du traitement de la vidéo est inconnu.
PROCESSING Traitement de la vidéo... Une icône de vidéo apparaît dans l'application Google Photos, mais elle n'est pas encore visible.
READY Le traitement de la vidéo est terminé et peut maintenant être visionné. Important: Une tentative de téléchargement d'une vidéo qui n'est pas à l'état PRÊT peut échouer.
FAILED Un problème est survenu. Le traitement de la vidéo a échoué.

Contributeur

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 avez la portée 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

Crée un ou plusieurs éléments multimédias dans la bibliothèque Google Photos de l'utilisateur.

batchGet

Renvoie la liste des éléments multimédias pour les identifiants des éléments multimédias spécifiés.

get

Affiche l'élément multimédia correspondant à l'identifiant spécifié.

list

Répertorier tous les éléments multimédias d'une bibliothèque Google Photos d'un utilisateur

patch

Met à jour l'élément multimédia avec le id spécifié.
Recherche d'éléments multimédias dans la bibliothèque Google Photos d'un utilisateur.