Ressource: MediaItem
Représentation d'un élément multimédia (comme une photo ou une vidéo) dans Google Photos.
Représentation JSON |
---|
{ "id": string, "description": string, "productUrl": string, "baseUrl": string, "mimeType": string, "mediaMetadata": { object ( |
Champs | |
---|---|
id |
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 |
Description de l'élément multimédia. Ce nom est visible par l'utilisateur dans la section dédiée aux informations de l'élément dans l'application Google Photos. Il doit comporter moins de 1 000 caractères. Incluez uniquement du texte écrit par des utilisateurs. Les descriptions doivent fournir 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 tags et d'autres métadonnées. |
productUrl |
URL Google Photos de l'élément multimédia. Ce lien n'est disponible que s'il est connecté. Lorsqu'elle est récupérée à partir d'une recherche d'album, l'URL pointe vers l'élément qui se trouve dans l'album. |
baseUrl |
URL des octets de l'élément multimédia. Ce champ ne doit pas être utilisé tel quel. Avant de l'utiliser, vous devez ajouter des paramètres à cette URL. Consultez la documentation destinée aux développeurs pour obtenir la liste complète des paramètres acceptés. Par exemple, |
mimeType |
Type MIME de l'élément multimédia. Par exemple, |
mediaMetadata |
Métadonnées associées à l'élément multimédia, telles que la hauteur, la largeur ou l'heure de création. |
contributorInfo |
Informations sur l'utilisateur qui a ajouté cet élément multimédia. Notez que cet ID n'est inclus que lorsque vous utilisez |
filename |
Nom de fichier de l'élément multimédia. L'utilisateur peut le voir dans la section des 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 |
Champs | |
---|---|
creationTime |
Heure à laquelle l'élément multimédia a été créé pour la première fois (et non lors de son importation dans Google Photos). Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: |
width |
Largeur d'origine de l'élément multimédia (en pixels). |
height |
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 |
Métadonnées d'un type de contenu multimédia. |
video |
Métadonnées d'un type de contenu vidéo. |
Photo
Métadonnées spécifiques à une photo, telles que la valeur ISO, la longueur focale et la durée d'exposition. Certains de ces champs peuvent avoir une valeur nulle ou ne pas être inclus.
Représentation JSON |
---|
{ "cameraMake": string, "cameraModel": string, "focalLength": number, "apertureFNumber": number, "isoEquivalent": integer, "exposureTime": string } |
Champs | |
---|---|
cameraMake |
Marque de l'appareil photo avec lequel la photo a été prise. |
cameraModel |
Modèle de l'appareil photo avec lequel la photo a été prise. |
focalLength |
Longueur focale de l'objectif de l'appareil photo avec lequel la photo a été prise. |
apertureFNumber |
Ouverture f de l'objectif de l'appareil photo avec lequel la photo a été prise. |
isoEquivalent |
ISO de l'appareil photo avec lequel la photo a été prise. |
exposureTime |
Durée d'exposition de l'ouverture de l'appareil photo au moment de la prise de vue. Durée en secondes avec un maximum de neuf chiffres après la virgule, se terminant par " |
Vidéo
Métadonnées spécifiques à une vidéo, telles que la fréquence d'images et l'état du traitement. Certains de ces champs peuvent avoir une valeur nulle ou ne pas être inclus.
Représentation JSON |
---|
{
"cameraMake": string,
"cameraModel": string,
"fps": number,
"status": enum ( |
Champs | |
---|---|
cameraMake |
Marque de la caméra avec laquelle la vidéo a été prise. |
cameraModel |
Modèle de l'appareil photo avec lequel la vidéo a été prise. |
fps |
Fréquence d'images de la vidéo. |
status |
État du traitement de la vidéo. |
VideoProcessingStatus
État du traitement d'une vidéo importée dans Google Photos.
Enums | |
---|---|
UNSPECIFIED |
État du traitement de la vidéo 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. Toutefois, elle ne peut pas encore être lue. |
READY |
Le traitement de la vidéo est terminé et vous pouvez maintenant la regarder. Important: Le téléchargement d'une vidéo qui n'est pas PRÊT peut échouer. |
FAILED |
Une erreur a empêché le traitement de la vidéo. |
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 du champ d'application de partage.
Représentation JSON |
---|
{ "profilePictureBaseUrl": string, "displayName": string } |
Champs | |
---|---|
profilePictureBaseUrl |
URL de la photo de profil du contributeur. |
displayName |
Nom à afficher du contributeur. |
Méthodes |
|
---|---|
|
Crée un ou plusieurs éléments multimédias dans la bibliothèque Google Photos d'un utilisateur. |
|
Renvoie la liste des éléments multimédias pour les identifiants d'éléments multimédias spécifiés. |
|
Renvoie l'élément multimédia pour l'identifiant d'élément multimédia spécifié. |
|
Permet de répertorier tous les éléments multimédias de la bibliothèque Google Photos d'un utilisateur. |
|
Met à jour l'élément multimédia avec le id spécifié. |
|
Recherche des éléments multimédias dans la bibliothèque Google Photos d'un utilisateur. |