Recurso: MediaItem
Representación de un elemento multimedia (como una foto o un video) en Google Fotos.
Representación JSON |
---|
{ "id": string, "description": string, "productUrl": string, "baseUrl": string, "mimeType": string, "mediaMetadata": { object ( |
Campos | |
---|---|
id |
Es el identificador del elemento multimedia. Este es un identificador persistente que se puede usar entre sesiones para identificar este elemento multimedia. |
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. |
productUrl |
URL de Google Fotos del elemento multimedia. Este vínculo solo estará disponible para los usuarios si accedieron a sus cuentas. Cuando se recupera de una búsqueda de álbum, la URL apunta al elemento dentro del álbum. |
baseUrl |
Una URL a los bytes del elemento multimedia. No se debe usar tal como está. Se deben agregar parámetros a esta URL antes de usarla. Consulta la documentación para desarrolladores para obtener una lista completa de los parámetros compatibles. Por ejemplo, |
mimeType |
Es el tipo de MIME del elemento multimedia. Por ejemplo, |
mediaMetadata |
Son los metadatos relacionados con el elemento multimedia, como la altura, el ancho o la hora de creación. |
contributorInfo |
Información sobre el usuario que agregó este elemento multimedia. Ten en cuenta que esto solo se incluye cuando se usa |
filename |
Es el nombre de archivo del elemento multimedia. El usuario puede verlo en la sección de información del elemento en la app de Google Fotos. |
MediaMetadata
Metadatos de un elemento multimedia
Representación JSON |
---|
{ "creationTime": string, "width": string, "height": string, // Union field |
Campos | |
---|---|
creationTime |
Hora en la que se creó el elemento multimedia por primera vez (no cuando se subió a Google Fotos). Una marca de tiempo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
width |
Es el ancho original (en píxeles) del elemento multimedia. |
height |
Es la altura original (en píxeles) del elemento multimedia. |
Campo de unión metadata . Metadatos del elemento multimedia específico del tipo de contenido multimedia subyacente que representa. Las direcciones (metadata ) solo pueden ser una de las siguientes opciones: |
|
photo |
Metadatos de un tipo de contenido multimedia de foto. |
video |
Metadatos de un tipo de medio de video. |
Foto
Son los metadatos específicos de una foto, como la escala ISO, la longitud focal y el tiempo de exposición. Algunos de estos campos pueden ser nulos o no estar incluidos.
Representación JSON |
---|
{ "cameraMake": string, "cameraModel": string, "focalLength": number, "apertureFNumber": number, "isoEquivalent": integer, "exposureTime": string } |
Campos | |
---|---|
cameraMake |
Marca de la cámara con la que se tomó la foto. |
cameraModel |
Modelo de la cámara con la que se tomó la foto. |
focalLength |
Longitud focal de la lente de la cámara con la que se tomó la foto. |
apertureFNumber |
Apertura del número de la lente de la cámara con la que se tomó la foto. |
isoEquivalent |
ISO de la cámara con la que se tomó la foto. |
exposureTime |
Indica el tiempo de exposición de la apertura de la cámara cuando se tomó la foto. Una duración en segundos con hasta nueve dígitos decimales que terminen en " |
Video
Son los metadatos específicos de un video, como los FPS y el estado de procesamiento. Algunos de estos campos pueden ser nulos o no estar incluidos.
Representación JSON |
---|
{
"cameraMake": string,
"cameraModel": string,
"fps": number,
"status": enum ( |
Campos | |
---|---|
cameraMake |
Marca de la cámara con la que se grabó el video |
cameraModel |
Modelo de la cámara con la que se grabó el video. |
fps |
Velocidad de fotogramas del video. |
status |
Estado de procesamiento del video. |
VideoProcessingStatus
Estado del procesamiento de un video que se está subiendo a Google Fotos.
Enumeradores | |
---|---|
UNSPECIFIED |
Se desconoce el estado de procesamiento del video. |
PROCESSING |
Se está procesando el video. El usuario ve un ícono de este video en la app de Google Fotos, pero aún no se puede reproducir. |
READY |
Se completó el procesamiento del video y ya está listo para verlo. Importante: Si intentas descargar un video que no está en estado READY, es posible que falle. |
FAILED |
Se produjo un error y no se pudo procesar el video. |
ContributorInfo
Información sobre el usuario que agregó el elemento multimedia. Ten en cuenta que esta información solo se incluye si el elemento multimedia está dentro de un álbum compartido creado por tu app y si tienes permiso para compartir.
Representación JSON |
---|
{ "profilePictureBaseUrl": string, "displayName": string } |
Campos | |
---|---|
profilePictureBaseUrl |
URL a la foto de perfil del colaborador |
displayName |
Nombre visible del colaborador |
Métodos |
|
---|---|
|
Crea uno o más elementos multimedia en la biblioteca de Google Fotos de un usuario. |
|
Muestra la lista de elementos multimedia de los identificadores de elementos multimedia especificados. |
|
Muestra el elemento multimedia para el identificador de elemento multimedia especificado. |
|
Enumera todos los elementos multimedia de la biblioteca de Google Fotos de un usuario. |
|
Actualiza el elemento multimedia con el id especificado. |
|
Busca elementos multimedia en la biblioteca de Google Fotos de un usuario. |