REST Resource: mediaItems

Recurso: MediaItem

Representação de um item de mídia (como uma foto ou um vídeo) no Google Fotos.

Representação JSON 
{
  "id": string,
  "description": string,
  "productUrl": string,
  "baseUrl": string,
  "mimeType": string,
  "mediaMetadata": {
    object (MediaMetadata)
  },
  "contributorInfo": {
    object (ContributorInfo)
  },
  "filename": string
}
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.
description

string

Descrição do item de mídia. Isso é mostrado ao usuário na seção de informações do item no app Google Fotos. Precisa ter menos de 1.000 caracteres. Inclua apenas textos escritos pelos usuários. As descrições precisam adicionar contexto e ajudar os usuários a entender a mídia. Não inclua strings geradas automaticamente, como nomes de arquivos, tags e outros metadados.
productUrl

string

URL do Google Fotos para o item de mídia. Esse link só vai estar disponível para o usuário se ele tiver feito login. Quando recuperado de uma pesquisa de álbum, o URL aponta para o item dentro do álbum.
baseUrl

string

Um URL para os bytes do item de mídia. Não use esse URL como está. Os parâmetros precisam ser anexados a ele antes do uso. Consulte a documentação para desenvolvedores e confira uma lista completa dos parâmetros aceitos. 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 item de mídia. Por exemplo, image/jpeg.
mediaMetadata

object (MediaMetadata)

Metadados relacionados ao item de mídia, como altura, largura ou data de criação.
contributorInfo

object (ContributorInfo)

Informações sobre o usuário que adicionou o item de mídia. Observe que isso só é incluído ao usar mediaItems.search com o ID de um álbum compartilhado. O álbum precisa ser criado pelo seu app, e você precisa ter o escopo de compartilhamento.
filename

string

Nome do arquivo do item de mídia. Essa informação é mostrada ao usuário na seção de informações do item no app Google Fotos.

MediaMetadata

Metadados para um item de mídia.

Representação JSON 
{
  "creationTime": string,
  "width": string,
  "height": string,

  // Union field metadata can be only one of the following:
  "photo": {
    object (Photo)
  },
  "video": {
    object (Video)
  }
  // End of list of possible types for union field metadata.
}
Campos
creationTime

string (Timestamp format)

A hora em que o item de mídia foi criado pela primeira vez (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".
width

string (int64 format)

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

string (int64 format)

Altura original (em pixels) do item de mídia.
Campo de união metadata. Metadados do item de mídia específico ao tipo de mídia que ele representa. metadata pode ser apenas de um dos tipos a seguir:
photo

object (Photo)

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

object (Video)

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

Foto

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 incluídos.

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

string

Marca da câmera com que a foto foi tirada.
cameraModel

string

Modelo da câmera com que a foto foi tirada.
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".

Vídeo

Metadados específicos de um vídeo, como QPS e status de processamento. Alguns desses campos podem ser nulos ou não serem incluídos.

Representação JSON 
{
  "cameraMake": string,
  "cameraModel": string,
  "fps": number,
  "status": enum (VideoProcessingStatus)
}
Campos
cameraMake

string

Marca da câmera com que o vídeo foi feito.
cameraModel

string

Modelo da câmera com que o vídeo foi feito.
fps

number

Frame rate do vídeo.
status

enum (VideoProcessingStatus)

Status de processamento do vídeo.

VideoProcessingStatus

Status de processamento de um vídeo sendo enviado para o Google Fotos.

Enums
UNSPECIFIED O status de processamento do vídeo é desconhecido.
PROCESSING O vídeo está sendo processado. O usuário vê um ícone para este vídeo no app Google Fotos. No entanto, ele ainda não pode ser reproduzido.
READY O processamento do vídeo foi concluído, e ele está pronto para ser assistido. Importante: a tentativa de fazer o download de um vídeo que não esteja no estado PRONTO pode falhar.
FAILED Algo deu errado e não foi possível processar o vídeo.

ContributorInfo

Informações sobre o usuário que adicionou o item de mídia. Essas informações são incluídas apenas se o item de mídia estiver em um álbum compartilhado criado pelo seu app e você tiver o escopo de compartilhamento.

Representação JSON 
{
  "profilePictureBaseUrl": string,
  "displayName": string
}
Campos
profilePictureBaseUrl

string

URL da foto do perfil do colaborador.
displayName

string

Nome de exibição do colaborador.

Métodos

batchCreate

 Cria um ou mais itens de mídia na biblioteca do Google Fotos de um usuário.

batchGet

 Retorna a lista de itens de mídia para os identificadores de itens de mídia especificados.

get

 Retorna o item de mídia para o identificador de item de mídia especificado.

list

 Lista todos os itens de mídia da biblioteca do Google Fotos de um usuário.

patch

 Atualiza o item de mídia com o id especificado.
Pesquisa itens de mídia na biblioteca do Google Fotos de um usuário.