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 información detallada sobre el paso 1, cómo subir 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 y la posición del álbum, el elemento multimedia se agrega al álbum en la posición especificada.

Si la llamada contiene varios elementos multimedia, estos se agregan en la posición especificada. Si creas un elemento multimedia en un álbum compartido donde no eres el propietario, no puedes colocar el elemento multimedia. Si lo haces, se mostrará 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 donde 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. Lista de elementos multimedia que se crearán. Se admite un máximo de 50 elementos multimedia por llamada.
albumPosition

object (AlbumPosition)

Posición en el álbum donde 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

Se creó la lista de elementos multimedia.

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. Se creó la lista de elementos multimedia.

Permisos de autorización

Se necesita uno de los siguientes alcances de OAuth:

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

NewMediaItem

Nuevo elemento multimedia 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. El usuario puede verlo en la sección de información del elemento en la app de Google Fotos. Debe tener menos de 1,000 caracteres. Incluye solo texto escrito por usuarios. Las descripciones deben agregar contexto y ayudar a los usuarios a comprender el contenido multimedia. No incluyas ninguna cadena generada automáticamente, como nombres de archivo, etiquetas y otros metadatos.
Campo de unión new_media_item_type. El nuevo elemento multimedia puede ser de varios tipos diferentes; esto depende de la ruta de carga. Las cargas admitidas actualmente solo usan la ruta de acceso de elementos multimedia simples. 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 elemento uploadToken incluido.

SimpleMediaItem

Un elemento multimedia simple que se creará en Google Fotos con un token de carga.

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

string

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

string

Nombre de archivo con extensión del elemento multimedia. El usuario podrá verlo 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 nuevo elemento multimedia.

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

string

El token de carga que se usó para crear este elemento multimedia nuevo (simple). Solo se completa si el elemento multimedia es simple y requiere un único 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 detalles sobre este campo, consulta Estado.
mediaItem

object (MediaItem)

Elemento multimedia creado con el token de carga Se propaga si no se produjeron errores y el elemento multimedia se creó correctamente.