REST Resource: mediaItems

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 (MediaMetadata)
  },
  "contributorInfo": {
    object (ContributorInfo)
  },
  "filename": string
}
Campos
id

string

Es el identificador del elemento multimedia. Es un identificador persistente que se puede usar entre sesiones para identificar este elemento multimedia.
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.
productUrl

string

Es la URL de Google Fotos del elemento multimedia. Este vínculo solo está disponible para el usuario si accedió a su cuenta. Cuando se recupera de una búsqueda de álbum, la URL apunta al elemento dentro del álbum.
baseUrl

string

Es 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 admitidos. Por ejemplo, '=w2048-h1024' establecerá las dimensiones de un elemento multimedia de tipo foto para que tenga un ancho de 2,048 px y una altura de 1,024 px.
mimeType

string

Es el tipo MIME del elemento multimedia. Por ejemplo, image/jpeg.
mediaMetadata

object (MediaMetadata)

Son metadatos relacionados con el elemento multimedia, como la altura, el ancho o la hora de creación.
contributorInfo

object (ContributorInfo)

Es la información sobre el usuario que agregó este elemento multimedia. Ten en cuenta que esto solo se incluye cuando se usa mediaItems.search con el ID de un álbum compartido. Tu app debe crear el álbum y debes tener el permiso de uso compartido.
filename

string

Es el nombre del archivo del elemento multimedia. Se muestra al usuario en la sección de información del elemento en la app de Google Fotos.

MediaMetadata

Son los metadatos de un elemento multimedia.

Representación JSON 
{
  "creationTime": string,
  "width": string,
  "height": string,

  // Union field metadata can be only one of the following:
  "photo": {
    object (Photo)
  },
  "video": {
    object (Video)
  }
  // End of list of possible types for union field metadata.
}
Campos
creationTime

string (Timestamp format)

Es la hora en que se creó el elemento multimedia por primera vez (no la hora en que se subió a Google Fotos).

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
width

string (int64 format)

Es el ancho original (en píxeles) del elemento multimedia.
height

string (int64 format)

Es la altura original (en píxeles) del elemento multimedia.
Campo de unión metadata. Son los metadatos del elemento multimedia específicos del tipo de medio subyacente que representa. Las direcciones (metadata) solo pueden ser una de las siguientes opciones:
photo

object (Photo)

Son los metadatos de un tipo de medio de foto.
video

object (Video)

Son los metadatos de un tipo de contenido multimedia de video.

Foto

Son metadatos específicos de una foto, como el ISO, la longitud focal y el tiempo de exposición. Es posible que algunos de estos campos sean nulos o no se incluyan.

Representación JSON 
{
  "cameraMake": string,
  "cameraModel": string,
  "focalLength": number,
  "apertureFNumber": number,
  "isoEquivalent": integer,
  "exposureTime": string
}
Campos
cameraMake

string

Es la marca de la cámara con la que se tomó la foto.
cameraModel

string

Es el modelo de la cámara con la que se tomó la foto.
focalLength

number

Es la longitud focal del lente de la cámara con el que se tomó la foto.
apertureFNumber

number

Es el número f de apertura del lente de la cámara con el que se tomó la foto.
isoEquivalent

integer

Es el ISO de la cámara con la que se tomó la foto.
exposureTime

string (Duration format)

Es 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 terminan en “s”. Ejemplo: "3.5s".

Video

Son metadatos específicos de un video, por ejemplo, los fps y el estado de procesamiento. Es posible que algunos de estos campos sean nulos o no se incluyan.

Representación JSON 
{
  "cameraMake": string,
  "cameraModel": string,
  "fps": number,
  "status": enum (VideoProcessingStatus)
}
Campos
cameraMake

string

Es la marca de la cámara con la que se grabó el video.
cameraModel

string

Es el modelo de la cámara con la que se grabó el video.
fps

number

Es la velocidad de fotogramas del video.
status

enum (VideoProcessingStatus)

Es el estado de procesamiento del video.

VideoProcessingStatus

Estado de procesamiento de un video que se sube a Google Fotos.

Enumeraciones
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 mirarse. Importante: Es posible que falle la descarga de un video que no esté en el estado READY.
FAILED Se produjo un error y no se pudo procesar el video.

ContributorInfo

Es la información sobre el usuario que agregó el elemento multimedia. Ten en cuenta que esta información solo se incluye si el elemento multimedia se encuentra en un álbum compartido que creó tu app y tienes el permiso de uso compartido.

Representación JSON 
{
  "profilePictureBaseUrl": string,
  "displayName": string
}
Campos
profilePictureBaseUrl

string

Es la URL de la foto de perfil del colaborador.
displayName

string

Es el nombre visible del colaborador.

Métodos

batchCreate

batchGet

get

list

patch

 Actualiza el elemento multimedia con el id especificado.