Method: mediaItems.batchCreate

Crea uno o más elementos multimedia en la biblioteca de Google Fotos de un usuario.

Este es el segundo paso para crear un elemento multimedia. Para obtener detalles sobre el paso 1, que consiste en subir los bytes sin procesar a un servidor de Google, consulta Cómo subir contenido multimedia.

Esta llamada agrega el elemento multimedia a la biblioteca. Si se especifica un id de álbum, la llamada también agrega el elemento multimedia al álbum. Cada álbum puede contener hasta 20,000 elementos multimedia. De forma predeterminada, el elemento multimedia se agregará al final de la biblioteca o el álbum.

Si se definen un id de álbum y una posición, el elemento multimedia se agrega al álbum en la posición especificada.

Si la llamada contiene varios elementos multimedia, se agregan en la posición especificada. Si creas un elemento multimedia en un álbum compartido del que no eres propietario, no podrás posicionarlo. De lo contrario, se generará un error BAD REQUEST.

Solicitud HTTP

POST https://photoslibrary.googleapis.com/v1/mediaItems:batchCreate

La URL usa la sintaxis de la transcodificación gRPC.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "albumId": string,
  "newMediaItems": [
    {
      object (NewMediaItem)
    }
  ],
  "albumPosition": {
    object (AlbumPosition)
  }
}
Campos
albumId

string

Es el identificador del álbum al que se agregan los elementos multimedia. Los elementos multimedia también se agregan a la biblioteca del usuario. Este paso es opcional,
newMediaItems[]

object (NewMediaItem)

Obligatorio. Es la lista de elementos multimedia que se crearán. Se pueden incluir hasta 50 elementos multimedia por llamada.
albumPosition

object (AlbumPosition)

Es la posición en el álbum en la que se agregan los elementos multimedia. Si no se especifica, los elementos multimedia se agregan al final del álbum (según el valor predeterminado, es decir, LAST_IN_ALBUM). La solicitud falla si se configura este campo y no se especifica albumId. La solicitud también fallará si configuras el campo y no eres el propietario del álbum compartido.

Cuerpo de la respuesta

Lista de elementos multimedia creados.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "newMediaItemResults": [
    {
      object (NewMediaItemResult)
    }
  ]
}
Campos
newMediaItemResults[]

object (NewMediaItemResult)

Solo salida. Lista de elementos multimedia creados.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.sharing

NewMediaItem

Es un elemento multimedia nuevo que se crea en la cuenta de Google Fotos de un usuario.

Representación 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.
}
Campos
description

string

Es la descripción del elemento multimedia. Se muestra al usuario en la sección de información del elemento en la app de Google Fotos. Debe tener menos de 1,000 caracteres. Solo incluye texto escrito por los usuarios. Las descripciones deben agregar contexto y ayudar a los usuarios a comprender el contenido multimedia. No incluyas cadenas generadas automáticamente, como nombres de archivos, etiquetas y otros metadatos.
Campo de unión new_media_item_type. El nuevo elemento multimedia puede ser de varios tipos diferentes, lo que depende de la ruta de carga. Las cargas admitidas actualmente solo usan la ruta de acceso simple del elemento multimedia. Las direcciones (new_media_item_type) solo pueden ser una de las siguientes opciones:
simpleMediaItem

object (SimpleMediaItem)

Un nuevo elemento multimedia que se subió a través del uploadToken incluido.

SimpleMediaItem

Es un elemento multimedia simple que se creará en Google Fotos a través de un token de carga.

Representación JSON 
{
  "uploadToken": string,
  "fileName": string
}
Campos
uploadToken

string

Es un token que identifica los bytes de contenido multimedia que se subieron a Google.
fileName

string

Es el nombre del archivo con la extensión del elemento multimedia. Esto se muestra al usuario en Google Fotos. Si se configura este campo, se ignora el nombre de archivo especificado durante el proceso de carga de bytes. El nombre del archivo, incluida la extensión, no debe tener más de 255 caracteres. Este paso es opcional,

NewMediaItemResult

Resultado de la creación de un elemento multimedia nuevo.

Representación JSON 
{
  "uploadToken": string,
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
Campos
uploadToken

string

Es el token de carga que se usó para crear este nuevo elemento multimedia (simple). Solo se propaga si el elemento multimedia es simple y requiere un solo token de carga.
status

object (Status)

Si se produjo un error durante la creación de este elemento multimedia, este campo se propagará con información relacionada con el error. Para obtener más información sobre este campo, consulta Estado.
mediaItem

object (MediaItem)

Es el elemento multimedia creado con el token de carga. Se propaga si no se produjo ningún error y el elemento multimedia se creó correctamente.