REST Resource: mediaItems

Recurso: PickedMediaItem

Representación de una foto o un video que eligió el usuario.

Representación JSON
{
  "id": string,
  "createTime": string,
  "type": enum (Type),
  "mediaFile": {
    object (MediaFile)
  }
}
Campos
id

string

Es el identificador del elemento multimedia.

Es un identificador persistente que se puede usar entre sesiones para identificar este elemento multimedia.

createTime

string (Timestamp format)

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

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

type

enum (Type)

Es el tipo de este elemento multimedia.

mediaFile

object (MediaFile)

Es el archivo multimedia que constituye este elemento multimedia.

Tipo

Es el tipo de elemento multimedia.

Enumeraciones
TYPE_UNSPECIFIED No se especifica el tipo.
PHOTO El elemento multimedia representa una foto.
VIDEO El elemento multimedia representa un video.

MediaFile

Representación de un archivo multimedia.

Representación JSON
{
  "baseUrl": string,
  "mimeType": string,
  "filename": string,
  "mediaFileMetadata": {
    object (MediaFileMetadata)
  }
}
Campos
baseUrl

string

Es una URL para recuperar los bytes del archivo multimedia.

Para descargar un archivo multimedia, el cliente de la API debe agregar los parámetros especificados en la documentación para desarrolladores a esta URL.

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 archivo multimedia. Por ejemplo, image/jpeg.

filename

string

Es el nombre del archivo multimedia.

mediaFileMetadata

object (MediaFileMetadata)

Son metadatos relacionados con el archivo multimedia, como la altura y el ancho.

MediaFileMetadata

Son metadatos sobre un archivo multimedia.

Representación JSON
{
  "width": integer,
  "height": integer,
  "cameraMake": string,
  "cameraModel": string,

  // Union field metadata can be only one of the following:
  "photoMetadata": {
    object (PhotoMetadata)
  },
  "videoMetadata": {
    object (VideoMetadata)
  }
  // End of list of possible types for union field metadata.
}
Campos
width

integer

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

height

integer

Es la altura original (en píxeles) del archivo multimedia.

cameraMake

string

Es la marca de la cámara con la que se capturó el contenido multimedia.

cameraModel

string

Es el modelo de la cámara con la que se capturó el contenido multimedia.

Campo de unión metadata. Son los metadatos del archivo multimedia específicos de su tipo de contenido. Las direcciones (metadata) solo pueden ser una de las siguientes opciones:
photoMetadata

object (PhotoMetadata)

Son los metadatos de un tipo de medio de foto.

videoMetadata

object (VideoMetadata)

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

PhotoMetadata

Son metadatos específicos de una foto, como el ISO, la distancia focal y el tiempo de exposición.

Es posible que algunos de estos campos no estén configurados.

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

number

Es la distancia 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".

VideoMetadata

Son metadatos específicos de un video. Por ejemplo, fps.

Representación JSON
{
  "fps": number,
  "processingStatus": enum (VideoProcessingStatus)
}
Campos
fps

number

Es la velocidad de fotogramas del video.

processingStatus

enum (VideoProcessingStatus)

Es el estado de procesamiento del video.

VideoProcessingStatus

Estado de procesamiento de un video almacenado en Google Fotos.

Enumeraciones
UNSPECIFIED No se especificó 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, por lo que ya puedes mirarlo.

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.

Métodos

list

Muestra una lista de los elementos multimedia que eligió el usuario durante la sesión especificada.