REST Resource: mediaItems

Recurso: PickedMediaItem

Representação de uma foto ou um vídeo escolhido pelo usuário.

Representação JSON 
{
  "id": string,
  "createTime": string,
  "type": enum (Type),
  "mediaFile": {
    object (MediaFile)
  }
}
Campos
id

string

Identificador do item de mídia.

É um identificador persistente que pode ser usado entre sessões para identificar esse item de mídia.
createTime

string (Timestamp format)

Hora em que o item de mídia foi criado (não quando foi enviado para o Google Fotos).

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
type

enum (Type)

O tipo deste item de mídia.
mediaFile

object (MediaFile)

O arquivo de mídia que constitui este item de mídia.

Tipo

O tipo de um item de mídia.

Tipos enumerados
TYPE_UNSPECIFIED O tipo não está especificado.
PHOTO O item de mídia representa uma foto.
VIDEO O item de mídia representa um vídeo.

MediaFile

Representação de um arquivo de mídia.

Representação JSON 
{
  "baseUrl": string,
  "mimeType": string,
  "filename": string,
  "mediaFileMetadata": {
    object (MediaFileMetadata)
  }
}
Campos
baseUrl

string

Um URL para buscar os bytes do arquivo de mídia.

Para fazer o download de um arquivo de mídia, o cliente da API precisa adicionar os parâmetros especificados na documentação do desenvolvedor a esse URL.

Por exemplo, '=w2048-h1024' vai definir as dimensões de um item de mídia do tipo foto com largura de 2048 px e altura de 1024 px.
mimeType

string

Tipo MIME do arquivo de mídia. Por exemplo, image/jpeg.
filename

string

Nome do arquivo de mídia.
mediaFileMetadata

object (MediaFileMetadata)

Metadados relacionados ao arquivo de mídia, como altura e largura.

MediaFileMetadata

Metadados sobre um arquivo de mídia.

Representação 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

Largura original (em pixels) do arquivo de mídia.
height

integer

Altura original (em pixels) do arquivo de mídia.
cameraMake

string

Marca da câmera com que a mídia foi capturada.
cameraModel

string

Modelo da câmera com que a mídia foi capturada.
Campo de união metadata. Metadados do arquivo de mídia específicos do tipo de mídia. metadata pode ser apenas de um dos tipos a seguir:
photoMetadata

object (PhotoMetadata)

Metadados para um tipo de mídia de foto.
videoMetadata

object (VideoMetadata)

Metadados de um tipo de mídia de vídeo.

PhotoMetadata

Metadados específicos de uma foto, como ISO, distância focal e tempo de exposição.

Alguns desses campos podem não estar definidos.

Representação JSON 
{
  "focalLength": number,
  "apertureFNumber": number,
  "isoEquivalent": integer,
  "exposureTime": string
}
Campos
focalLength

number

Distância focal da lente da câmera com que a foto foi tirada.
apertureFNumber

number

Número f da abertura da lente da câmera com que a foto foi tirada.
isoEquivalent

integer

ISO da câmera com que a foto foi tirada.
exposureTime

string (Duration format)

Tempo de exposição da abertura da câmera quando a foto foi tirada.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

VideoMetadata

Metadados específicos de um vídeo. Por exemplo, fps.

Representação JSON 
{
  "fps": number,
  "processingStatus": enum (VideoProcessingStatus)
}
Campos
fps

number

Frame rate do vídeo.
processingStatus

enum (VideoProcessingStatus)

Status de processamento do vídeo.

VideoProcessingStatus

Status de processamento de um vídeo armazenado no Google Fotos.

Tipos enumerados
UNSPECIFIED O status do processamento de vídeo não foi especificado.
PROCESSING

O vídeo está sendo processado.

O usuário vê um ícone desse vídeo no app Google Fotos, mas ele ainda não pode ser reproduzido.
READY

O processamento do vídeo foi concluído, e ele está pronto para ser assistido.

A tentativa de baixar um vídeo que não está no estado READY pode falhar.
FAILED Algo deu errado, e o vídeo não foi processado.

Métodos

list

 Retorna uma lista de itens de mídia escolhidos pelo usuário durante a sessão especificada.