Method: mediaItems.batchCreate

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, l'importation des octets bruts sur un serveur Google, consultez Importer du contenu multimé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 un id et une position d'album sont tous deux définis, l'élément multimédia est ajouté à l'album à la position spécifiée.

Si l'appel contient plusieurs éléments multimédias, ceux-ci 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 (NewMediaItem)
    }
  ],
  "albumPosition": {
    object (AlbumPosition)
  }
}
Champs
albumId

string

Identifiant de l'album dans lequel les éléments multimédias ont été ajoutés. Les éléments multimédias sont également ajoutés à la bibliothèque de l'utilisateur. Ce champ est facultatif.

newMediaItems[]

object (NewMediaItem)

Obligatoire. Liste des éléments multimédias à créer. 50 éléments multimédias au maximum par appel.

albumPosition

object (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 LAST_IN_ALBUM). La requête échoue si ce champ est défini et si le albumId n'est pas spécifié. La demande échouera également si vous définissez le champ et n'êtes pas le propriétaire de l'album partagé.

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 (NewMediaItemResult)
    }
  ]
}
Champs
newMediaItemResults[]

object (NewMediaItemResult)

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

Nouvel élément multimédia

Nouvel élément multimédia créé dans le compte Google Photos d'un utilisateur.

Représentation JSON
{
  "description": string,

  // Union field new_media_item_type can be only one of the following:
  "simpleMediaItem": {
    object (SimpleMediaItem)
  }
  // End of list of possible types for union field new_media_item_type.
}
Champs
description

string

Description de l'élément multimédia. Ce nom est visible par l'utilisateur dans la section des informations sur l'élément de l'application Google Photos. Il doit comporter moins de 1 000 caractères. N'incluez que le texte rédigé par les utilisateurs. Les descriptions doivent fournir du contexte et aider les utilisateurs à comprendre le contenu multimédia. 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.

Champ d'union new_media_item_type. Le nouvel élément multimédia peut être de différents types, selon le chemin d'importation. Les importations actuellement compatibles n'utilisent que le chemin d'élément multimédia simple. new_media_item_type ne peut être qu'un des éléments suivants :
simpleMediaItem

object (SimpleMediaItem)

Un nouvel élément multimédia importé via l'élément uploadToken inclus.

SimpleMediaItem

Élément multimédia simple à créer dans Google Photos via un jeton d'importation.

Représentation JSON
{
  "uploadToken": string,
  "fileName": string
}
Champs
uploadToken

string

Jeton identifiant les octets de contenus multimédias importés sur Google.

fileName

string

Nom de fichier avec l'extension de l'élément multimédia. L'utilisateur pourra voir ce nom 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 (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
Champs
uploadToken

string

Jeton d'importation utilisé pour créer cet élément multimédia (simple). N'est renseigné que si l'élément multimédia est simple et ne nécessite qu'un seul jeton d'importation.

status

object (Status)

Si une erreur s'est produite lors de la création de cet élément multimédia, les informations la concernant sont insérées dans ce champ. Pour en savoir plus sur ce champ, consultez la section État.

mediaItem

object (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éé.