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 tetap yang dapat digunakan di antara sesi untuk mengidentifikasi item media ini.

createTime

string (Timestamp format)

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

Stempel waktu dalam 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 secara default.
PHOTO Item media menampilkan gambar diam.
VIDEO Item media mewakili video.

MediaFile

Representasi setiap file byte media.

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

string

URL ke 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 foto jenis agar memiliki lebar 2048 piksel dan tinggi 1024 piksel.

mimeType

string

Jenis MIME dari file media. Misalnya, image/jpeg.

mediaFileMetadata

object (MediaFileMetadata)

Metadata yang terkait dengan file media seperti tinggi, lebar, atau waktu pembuatan.

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

cameraModel

string

Model kamera yang digunakan untuk mengambil foto.

Kolom union metadata. Metadata untuk file media khusus untuk jenis media pokok yang diwakilinya. 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 null atau tidak disertakan.

Representasi JSON
{
  "focalLength": number,
  "apertureFNumber": number,
  "isoEquivalent": integer,
  "exposureTime": string,
  "printMetadata": {
    object (PrintMetadata)
  }
}
Kolom
focalLength

number

Panjang fokal lensa kamera yang digunakan untuk mengambil foto.

apertureFNumber

number

Bukaan f nomor lensa kamera yang digunakan untuk mengambil foto.

isoEquivalent

integer

ISO kamera yang digunakan untuk mengambil foto.

exposureTime

string (Duration format)

Waktu eksposur bukaan kamera saat foto diambil.

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

printMetadata

object (PrintMetadata)

Metadata yang terkait dengan pencetakan foto.

PrintMetadata

Metadata yang menjelaskan properti terkait pencetakan untuk foto, misalnya skor kualitas cetak.

Representasi JSON
{
  "qualityScore": enum (Score)
}
Kolom
qualityScore

enum (Score)

Skor kualitas cetak foto, yang menentukan apakah foto tersebut bagus untuk dicetak.

Skor tersebut tidak boleh digunakan untuk menyarankan pengguna agar tidak melakukan pencetakan. Skor ditetapkan ke HIGH jika foto berkualitas tinggi dan pengguna mungkin ingin mencetaknya. Skor NORMAL menunjukkan bahwa foto mungkin tidak berkualitas tinggi. SCORE_UNSPECIFIED menunjukkan bahwa tidak ada skor yang tersedia.

Skor

Skor yang menjelaskan kesesuaian foto untuk dicetak.

Enum
SCORE_UNSPECIFIED Skor tidak ditentukan secara default.
HIGH Foto memiliki skor tinggi.
NORMAL Foto memiliki skor normal.

VideoMetadata

Metadata yang spesifik untuk video, misalnya, fps.

Representasi JSON
{
  "fps": number
}
Kolom
fps

number

Kecepatan frame video.

Metode

list

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