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, 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 álbum id, la llamada también agregará 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 las opciones de un id y una posición de á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 del que no eres propietario, no podrás posicionarlo. Si lo haces, se mostrará el 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 en el 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 permite 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

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.

Alcances 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

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. Esta información 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. Incluye solo 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 (esto 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

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

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

string

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

string

Nombre de archivo con extensión del elemento multimedia. Esta información 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 superar los 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 nuevo elemento multimedia (simple). Solo se completa 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 completará 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 produjo ningún error y el elemento multimedia se creó correctamente.