REST Resource: mediaItems

Resource: Varian

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. Nama 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 dihasilkan secara otomatis seperti nama file, tag, dan metadata lainnya.
productUrl

string

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

string

URL ke byte item media. Parameter ini tidak boleh digunakan sebagaimana 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 px dan tinggi 1024 px.
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 kode ini hanya disertakan jika 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 format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. 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 asli item media (dalam piksel).
Kolom union metadata. Metadata untuk item media khusus untuk jenis media dasar yang diwakilinya. metadata hanya ada berupa salah satu diantara 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 kosong 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, diakhiri dengan 's'. Contoh: "3.5s".

Video

Metadata yang khusus untuk video, misalnya, fps dan status pemrosesan. Beberapa kolom ini mungkin kosong 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 merekam video.
fps

number

Kecepatan frame video.
status

enum (VideoProcessingStatus)

Status pemrosesan video.

VideoProcessingStatus

Status pemrosesan video yang diupload ke Google Foto.

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

 Membuat satu atau beberapa item media di galeri Google Foto pengguna.

batchGet

 Menampilkan daftar item media untuk ID item media tertentu.

get

 Menampilkan item media untuk ID item media yang ditentukan.

list

 Menampilkan daftar semua item media dari galeri Google Foto pengguna.

patch

 Memperbarui item media dengan id yang ditentukan.
Menelusuri item media di galeri Google Foto pengguna.