REST Resource: mediaItems

Resource: PickedMediaItem

Representasi foto atau video yang dipilih oleh pengguna.

Representasi JSON
{
  "id": string,
  "createTime": string,
  "type": enum (Type),
  "mediaFile": {
    object (MediaFile)
  }
}
Kolom
id

string

ID untuk item media.

Ini adalah ID persisten yang dapat digunakan di antara sesi untuk mengidentifikasi item media ini.

createTime

string (Timestamp format)

Waktu pembuatan item media (bukan saat diupload ke Google Foto).

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

type

enum (Type)

Jenis item media ini.

mediaFile

object (MediaFile)

File media yang membentuk item media ini.

Jenis

Jenis item media.

Enum
TYPE_UNSPECIFIED Jenis tidak ditentukan.
PHOTO Item media mewakili foto.
VIDEO Item media mewakili video.

MediaFile

Representasi file media.

Representasi JSON
{
  "baseUrl": string,
  "mimeType": string,
  "filename": string,
  "mediaFileMetadata": {
    object (MediaFileMetadata)
  }
}
Kolom
baseUrl

string

URL untuk mengambil byte file media.

Untuk mendownload file media, klien API harus menambahkan parameter yang ditentukan dalam dokumentasi developer ke URL ini.

Misalnya, '=w2048-h1024' akan menetapkan dimensi item media berjenis foto agar memiliki lebar 2048 piksel dan tinggi 1024 piksel.

mimeType

string

Jenis MIME file media. Misalnya, image/jpeg.

filename

string

Nama file media.

mediaFileMetadata

object (MediaFileMetadata)

Metadata yang terkait dengan file media, seperti tinggi dan lebar.

MediaFileMetadata

Metadata tentang file media.

Representasi 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.
}
Kolom
width

integer

Lebar asli (dalam piksel) file media.

height

integer

Tinggi asli (dalam piksel) file media.

cameraMake

string

Merek kamera yang digunakan untuk mengambil media.

cameraModel

string

Model kamera yang digunakan untuk mengambil media.

Kolom union metadata. Metadata untuk file media yang spesifik untuk jenis medianya. metadata hanya dapat berupa salah satu dari berikut:
photoMetadata

object (PhotoMetadata)

Metadata untuk jenis media foto.

videoMetadata

object (VideoMetadata)

Metadata untuk jenis media video.

PhotoMetadata

Metadata yang spesifik untuk foto, seperti ISO, panjang fokus, dan waktu eksposur.

Beberapa kolom ini mungkin tidak ditetapkan.

Representasi JSON
{
  "focalLength": number,
  "apertureFNumber": number,
  "isoEquivalent": integer,
  "exposureTime": string
}
Kolom
focalLength

number

Panjang fokal lensa kamera yang digunakan untuk mengambil foto.

apertureFNumber

number

Angka f aperture lensa kamera yang digunakan untuk mengambil foto.

isoEquivalent

integer

ISO kamera yang digunakan untuk mengambil foto.

exposureTime

string (Duration format)

Waktu eksposur apertur kamera saat foto diambil.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

VideoMetadata

Metadata yang spesifik untuk video. Misalnya, fps.

Representasi JSON
{
  "fps": number,
  "processingStatus": enum (VideoProcessingStatus)
}
Kolom
fps

number

Kecepatan frame video.

processingStatus

enum (VideoProcessingStatus)

Memproses status video.

VideoProcessingStatus

Status pemrosesan video yang disimpan di Google Foto.

Enum
UNSPECIFIED Status pemrosesan video tidak ditentukan.
PROCESSING

Video sedang diproses.

Pengguna akan melihat ikon untuk video ini di aplikasi Google Foto; namun, video tersebut belum dapat diputar.

READY

Pemrosesan video telah selesai dan video ini sekarang siap ditonton.

Mencoba mendownload video yang tidak dalam status READY dapat gagal.

FAILED Terjadi error dan video gagal diproses.

Metode

list

Menampilkan daftar item media yang dipilih oleh pengguna selama sesi yang ditentukan.