REST Resource: mediaItems

Recurso: PickedMediaItem

Representación de una foto o un video que seleccionó 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)

Fecha y hora en que se creó el elemento multimedia (no cuando se subió a Google Fotos).

Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizada a Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
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

Es la 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 un alto de 1,024 px.
mimeType

string

Tipo MIME del archivo multimedia. Por ejemplo, image/jpeg.
filename

string

Nombre del archivo multimedia.
mediaFileMetadata

object (MediaFileMetadata)

Son los metadatos relacionados con el archivo de medios, como la altura y el ancho.

MediaFileMetadata

Son los 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

Ancho original (en píxeles) del archivo multimedia.
height

integer

Altura original (en píxeles) del archivo multimedia.
cameraMake

string

Marca de la cámara con la que se capturó el contenido multimedia.
cameraModel

string

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 medio. Las direcciones (metadata) solo pueden ser una de las siguientes opciones:
photoMetadata

object (PhotoMetadata)

Son los metadatos de un tipo de medio fotográfico.
videoMetadata

object (VideoMetadata)

Son los metadatos de un tipo de medio de video.

PhotoMetadata

Son los 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

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

number

Número f de apertura del lente de la cámara con la 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 los 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

Es el 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 y ya se puede mirar.

Es posible que no se pueda descargar un video que no esté en el estado READY.
FAILED Se produjo un error y no se pudo procesar el video.

Métodos

list

 Devuelve una lista de elementos multimedia que seleccionó el usuario durante la sesión especificada.