- Requête HTTP
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- NewMediaItem
- SimpleMediaItem
- NewMediaItemResult
- Essayer
Crée un ou plusieurs éléments multimédias dans la bibliothèque Google Photos d'un utilisateur.
Il s'agit de la deuxième étape pour créer un élément multimédia. Pour en savoir plus sur l'étape 1, à savoir l'importation des octets bruts sur un serveur Google, consultez Importer un média.
Cet appel ajoute l'élément multimédia à la bibliothèque. Si un id
d'album est spécifié, l'appel ajoute également l'élément multimédia à l'album. Chaque album peut contenir jusqu'à 20 000 éléments multimédias. Par défaut, l'élément multimédia est ajouté à la fin de la bibliothèque ou de l'album.
Si une id
et une position d'album sont définies, l'élément multimédia est ajouté à l'album à la position spécifiée.
Si l'appel contient plusieurs éléments multimédias, ils sont ajoutés à la position spécifiée. Si vous créez un élément multimédia dans un album partagé dont vous n'êtes pas le propriétaire, vous n'êtes pas autorisé à positionner l'élément multimédia. Cela entraînerait une erreur BAD REQUEST
.
Requête HTTP
POST https://photoslibrary.googleapis.com/v1/mediaItems:batchCreate
L'URL utilise la syntaxe de transcodage gRPC.
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Représentation JSON |
---|
{ "albumId": string, "newMediaItems": [ { object ( |
Champs | |
---|---|
albumId |
Identifiant de l'album dans lequel les éléments multimédias sont ajoutés. Les éléments multimédias sont également ajoutés à la bibliothèque de l'utilisateur. Ce champ est facultatif. |
newMediaItems[] |
Obligatoire. Liste des éléments multimédias à créer. 50 éléments multimédias maximum par appel. |
albumPosition |
Position dans l'album où les éléments multimédias sont ajoutés. Si aucune valeur n'est spécifiée, les éléments multimédias sont ajoutés à la fin de l'album (conformément à la valeur par défaut, à savoir |
Corps de la réponse
Liste d'éléments multimédias créée.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Représentation JSON |
---|
{
"newMediaItemResults": [
{
object ( |
Champs | |
---|---|
newMediaItemResults[] |
Uniquement en sortie. Liste d'éléments multimédias créée. |
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/photoslibrary
https://www.googleapis.com/auth/photoslibrary.appendonly
https://www.googleapis.com/auth/photoslibrary.sharing
NewMediaItem
Nouvel élément multimédia créé dans le compte Google Photos de l'utilisateur.
Représentation JSON |
---|
{ "description": string, // Union field |
Champs | |
---|---|
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. |
Champ d'union new_media_item_type . Le nouvel élément multimédia peut être de différents types, qui dépendent du chemin d'importation. Les importations actuellement compatibles n'utilisent que le chemin d'accès à l'élément multimédia simple. new_media_item_type ne peut être qu'un des éléments suivants : |
|
simpleMediaItem |
Un nouvel élément multimédia qui a été importé via le |
SimpleMediaItem
Un élément multimédia simple à créer dans Google Photos à l'aide d'un jeton d'importation.
Représentation JSON |
---|
{ "uploadToken": string, "fileName": string } |
Champs | |
---|---|
uploadToken |
Jeton identifiant les octets de contenus multimédias qui ont été importés dans Google. |
fileName |
Nom de fichier avec l'extension de l'élément multimédia. L'utilisateur peut le voir dans Google Photos. Le nom de fichier spécifié lors du processus d'importation d'octets est ignoré si ce champ est défini. Le nom du fichier, extension de fichier comprise, ne doit pas dépasser 255 caractères. Ce champ est facultatif. |
NewMediaItemResult
Résultat de la création d'un élément multimédia.
Représentation JSON |
---|
{ "uploadToken": string, "status": { object ( |
Champs | |
---|---|
uploadToken |
Jeton d'importation utilisé pour créer cet élément multimédia (simple). Renseigné uniquement si l'élément multimédia est simple et nécessite un seul jeton d'importation. |
status |
Si une erreur s'est produite lors de la création de cet élément multimédia, des informations la concernant sont renseignées dans ce champ. Pour en savoir plus sur ce champ, consultez État. |
mediaItem |
Élément multimédia créé avec le jeton d'importation. Il est renseigné si aucune erreur ne s'est produite et que l'élément multimédia a bien été créé. |