REST Resource: mediaItems

Recurso: PickedMediaItem

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

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

string

Identificador do item de mídia.

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

createTime

string (Timestamp format)

A hora em que o item de mídia foi criado (não quando foi enviado por upload para o 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 o item de mídia.

Tipo

O tipo de item de mídia.

Enums
TYPE_UNSPECIFIED O tipo não é especificado por padrão.
PHOTO O item de mídia representa uma imagem estática.
VIDEO O item de mídia representa um vídeo.

MediaFile

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

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

string

Um URL para 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' 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.

mediaFileMetadata

object (MediaFileMetadata)

Metadados relacionados ao arquivo de mídia, como altura, largura ou hora de criação.

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 foto foi tirada.

cameraModel

string

Modelo da câmera com que a foto foi tirada.

Campo de união metadata. Metadados do arquivo de mídia específico ao tipo de mídia subjacente que ele representa. 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 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 ser nulos ou não serem incluídos.

Representação JSON
{
  "focalLength": number,
  "apertureFNumber": number,
  "isoEquivalent": integer,
  "exposureTime": string,
  "printMetadata": {
    object (PrintMetadata)
  }
}
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".

printMetadata

object (PrintMetadata)

Metadados relacionados à impressão da foto.

PrintMetadata

Metadados que descrevem as propriedades relacionadas à impressão de uma foto, por exemplo, o índice de qualidade de impressão.

Representação JSON
{
  "qualityScore": enum (Score)
}
Campos
qualityScore

enum (Score)

Índice de qualidade de impressão de uma foto, que determina se a foto é boa para impressão.

A pontuação não deve ser usada para orientar os usuários contra a impressão. O nível será definido como HIGH se a foto for de alta qualidade e o usuário quiser imprimi-la. Uma pontuação de NORMAL indica que talvez a foto não tenha alta qualidade. SCORE_UNSPECIFIED indica que não há pontuação disponível.

Pontuação

Uma pontuação que descreve a adequação de impressão de uma foto.

Enums
SCORE_UNSPECIFIED A pontuação não é especificada por padrão.
HIGH A foto tem uma pontuação alta.
NORMAL A foto tem uma pontuação normal.

VideoMetadata

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

Representação JSON
{
  "fps": number
}
Campos
fps

number

Frame rate do vídeo.

Métodos

list

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