- Solicitud HTTP
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de la autorización
- NewMediaItem
- SimpleMediaItem
- NewMediaItemResult
- Pruébala
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 ( |
Campos | |
---|---|
albumId |
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[] |
Obligatorio. Lista de elementos multimedia que se crearán. Se admite un máximo de 50 elementos multimedia por llamada. |
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, |
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 ( |
Campos | |
---|---|
newMediaItemResults[] |
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 |
Campos | |
---|---|
description |
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 |
Un nuevo elemento multimedia que se subió a través del elemento |
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 |
El token que identifica los bytes de contenido multimedia que se subieron a Google. |
fileName |
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 ( |
Campos | |
---|---|
uploadToken |
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 |
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 |
Elemento multimedia creado con el token de carga Se propaga si no se produjeron errores y el elemento multimedia se creó correctamente. |