REST Resource: mediaItems

Recurso: PickedMediaItem

Representação de uma foto ou 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 permanente 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 ao Google Fotos).

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

type

enum (Type)

O tipo desse 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.

Enums
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 a esse URL os parâmetros especificados na documentação do desenvolvedor.

Por exemplo, '=w2048-h1024' vai definir as dimensões de um item de mídia do tipo foto para ter uma largura de 2.048 px e uma altura de 1.024 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 a qual 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ífico para o tipo de mídia. metadata pode ser apenas de um dos tipos a seguir:
photoMetadata

object (PhotoMetadata)

Metadados de um tipo de mídia de foto.

videoMetadata

object (VideoMetadata)

Metadados para 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 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.

Enums
UNSPECIFIED O status do processamento do vídeo não foi especificado.
PROCESSING

O vídeo está sendo processado.

O usuário vai encontrar um ícone para esse vídeo no app Google Fotos, mas ele ainda não pode ser assistido.

READY

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

A tentativa de fazer o download de um vídeo que não está no estado READY pode falhar.

FAILED Algo deu errado e não foi possível processar o vídeo.

Métodos

list

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