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 tetap 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 kurang dari 1000 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 bagi pengguna jika mereka sudah login. Jika diambil dari penelusuran album, URL akan mengarah ke item di dalam album tersebut.
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 foto jenis 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 fungsi ini hanya disertakan saat menggunakan mediaItems.search dengan ID album bersama. Album harus dibuat oleh aplikasi dan Anda harus memiliki cakupan berbagi.
filename

string

Nama file item media. 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 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".
width

string (int64 format)

Lebar asli (dalam piksel) item media.
height

string (int64 format)

Tinggi item media awal (dalam piksel).
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

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

Video

Metadata yang khusus 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 mengambil video.
cameraModel

string

Model kamera yang digunakan untuk mengambil video.
fps

number

Kecepatan frame video.
status

enum (VideoProcessingStatus)

Status pemrosesan video.

VideoProcessingStatus

Status pemrosesan video yang sedang diupload ke Google Foto.

Enum
UNSPECIFIED Status pemrosesan video tidak diketahui.
PROCESSING Video sedang diproses. Pengguna melihat ikon untuk video ini di aplikasi Google Foto; namun, video belum dapat diputar.
READY Pemrosesan video telah selesai dan sekarang siap ditonton. Penting: mencoba mendownload video yang tidak dalam status READY mungkin akan 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.