REST Resource: mediaItems

Resource: MediaItem

Representasi item media (seperti foto atau video) di Google Foto.

Representasi JSON 
{
  "id": string,
  "description": string,
  "productUrl": string,
  "baseUrl": string,
  "mimeType": string,
  "mediaMetadata": {
    object (MediaMetadata)
  },
  "contributorInfo": {
    object (ContributorInfo)
  },
  "filename": string
}
Kolom
id

string

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

string

Deskripsi item media. Ini ditampilkan kepada pengguna di bagian info item di aplikasi Google Foto. Harus lebih pendek dari 1.000 karakter. Hanya sertakan teks yang ditulis oleh pengguna. Deskripsi harus menambahkan konteks dan membantu pengguna memahami media. Jangan sertakan string yang dibuat secara otomatis seperti nama file, tag, dan metadata lainnya.
productUrl

string

URL Google Foto untuk item media. Link ini hanya tersedia untuk pengguna jika mereka login. Saat diambil dari penelusuran album, URL akan mengarah ke item di dalam album.
baseUrl

string

URL ke byte item media. URL ini tidak boleh digunakan apa adanya. Parameter harus ditambahkan ke URL ini sebelum digunakan. Lihat dokumentasi developer untuk mengetahui daftar lengkap parameter yang didukung. Misalnya, '=w2048-h1024' akan menetapkan dimensi item media jenis foto agar memiliki lebar 2048 piksel dan tinggi 1024 piksel.
mimeType

string

Jenis MIME item media. Misalnya, image/jpeg.
mediaMetadata

object (MediaMetadata)

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

object (ContributorInfo)

Informasi tentang pengguna yang menambahkan item media ini. Perhatikan bahwa ini hanya disertakan saat menggunakan mediaItems.search dengan ID album bersama. Album harus dibuat oleh aplikasi Anda dan Anda harus memiliki cakupan berbagi.
filename

string

Nama file item media. Informasi ini ditampilkan kepada pengguna di bagian info item di aplikasi Google Foto.

MediaMetadata

Metadata untuk item media.

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

string (Timestamp format)

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

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
width

string (int64 format)

Lebar asli (dalam piksel) item media.
height

string (int64 format)

Tinggi asli (dalam piksel) item media.
Kolom union metadata. Metadata untuk item media yang spesifik untuk jenis media pokok yang diwakilinya. metadata hanya dapat berupa salah satu dari berikut:
photo

object (Photo)

Metadata untuk jenis media foto.
video

object (Video)

Metadata untuk jenis media video.

Foto

Metadata yang spesifik untuk foto, seperti ISO, panjang fokus, dan waktu eksposur. Beberapa kolom ini mungkin null atau tidak disertakan.

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

string

Merek kamera yang digunakan untuk mengambil foto.
cameraModel

string

Model kamera yang digunakan untuk mengambil foto.
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".

Video

Metadata yang spesifik untuk video, misalnya, fps dan status pemrosesan. Beberapa kolom ini mungkin null atau tidak disertakan.

Representasi JSON 
{
  "cameraMake": string,
  "cameraModel": string,
  "fps": number,
  "status": enum (VideoProcessingStatus)
}
Kolom
cameraMake

string

Merek kamera yang digunakan untuk merekam video.
cameraModel

string

Model kamera yang digunakan untuk mengambil video.
fps

number

Kecepatan frame video.
status

enum (VideoProcessingStatus)

Memproses status video.

VideoProcessingStatus

Status pemrosesan video yang diupload ke Google Foto.

Enum
UNSPECIFIED Status pemrosesan video tidak diketahui.
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 sekarang siap ditonton. Penting: upaya mendownload video yang tidak dalam status SIAP dapat gagal.
FAILED Terjadi error dan video gagal diproses.

ContributorInfo

Informasi tentang pengguna yang menambahkan item media. Perhatikan bahwa informasi ini hanya disertakan jika item media berada dalam album bersama yang dibuat oleh aplikasi Anda dan Anda memiliki cakupan berbagi.

Representasi JSON 
{
  "profilePictureBaseUrl": string,
  "displayName": string
}
Kolom
profilePictureBaseUrl

string

URL ke foto profil kontributor.
displayName

string

Nama tampilan kontributor.

Metode

batchCreate

batchGet

get

list

patch

 Perbarui item media dengan id yang ditentukan.