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. É um identificador permanente que pode ser usado entre sessões para identificar esse item de mídia.
description

string

Descrição do item de mídia. Essa informação é mostrada ao usuário na seção de informações do item no app Google Fotos. Ela 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ó fica 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' define as dimensões de um item de mídia do tipo foto com largura de 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 data de criação.
contributorInfo

object (ContributorInfo)

Informações sobre o usuário que adicionou o item de mídia. Isso só é incluído quando você usa 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 de 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 (não quando foi enviado para o Google Fotos).

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" 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".
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íficos do tipo de mídia que ele representa. metadata pode ser apenas de um dos tipos a seguir:
photo

object (Photo)

Metadados de 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 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".

Vídeo

Metadados específicos de um vídeo, por exemplo, fps 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 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 encontra um ícone para esse 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. 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ã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 criados pelo app para os identificadores de item de mídia especificados.

get

 Retorna o item de mídia criado pelo app para o identificador de item de mídia especificado.

list

 Listar todos os itens de mídia criados pelo seu app na biblioteca do Google Fotos de um usuário.

patch

 Atualize o item de mídia criado pelo app com o id especificado.
Pesquisa itens de mídia criados pelo app na biblioteca do Google Fotos de um usuário.