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 as sessões para identificar esse item de mídia.
description

string

Descrição do item de mídia. Essa informação é exibida ao usuário na seção de informações do item no app Google Fotos. Precisa ter menos de 1.000 caracteres. Inclua apenas texto escrito pelos usuários. As descrições precisam agregar 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. Ele não deve ser usado como está. Os parâmetros precisam ser anexados a esse URL antes do uso. Consulte a documentação do desenvolvedor para uma lista completa dos parâmetros compatíveis. Por exemplo, '=w2048-h1024' vai definir as dimensões de um item de mídia do tipo foto como 2.048 px e 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 hora de criação.
contributorInfo

object (ContributorInfo)

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

string

Nome do arquivo do item de mídia. Essa informação é exibida 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)

Hora em que o item de mídia foi criado pela primeira vez, e não quando foi enviado para o Google Fotos.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, 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 para 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 a qual 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.

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

Video

Metadados específicos de um vídeo, como QPS e status de processamento. Alguns desses campos podem ser nulos ou não 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 gravado.
cameraModel

string

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

number

Frame rate do vídeo.
status

enum (VideoProcessingStatus)

Status de processamento do vídeo.

VideoProcessingStatus

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

Enums
UNSPECIFIED O status do processamento do vídeo é desconhecido.
PROCESSING O vídeo está sendo processado. O usuário verá um ícone do vídeo no app Google Fotos, mas ele ainda não poderá ser assistido.
READY O processamento do vídeo foi concluído e agora ele está pronto para visualização. Importante: a tentativa de fazer o download de um vídeo que não está 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ó serão incluídas se o item de mídia estiver em um álbum compartilhado criado pelo app e você tiver o escopo de compartilhamento.

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

string

URL para a 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 dos identificadores especificados de itens de mídia.

get

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

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.