REST Resource: mediaItems

Kaynak: MediaItem

Google Fotoğraflar'daki bir medya öğesinin (ör. fotoğraf veya video) temsili.

JSON gösterimi 
{
  "id": string,
  "description": string,
  "productUrl": string,
  "baseUrl": string,
  "mimeType": string,
  "mediaMetadata": {
    object (MediaMetadata)
  },
  "contributorInfo": {
    object (ContributorInfo)
  },
  "filename": string
}
Alanlar
id

string

Medya öğesinin tanımlayıcısıdır. Bu, medya öğesini tanımlamak için oturumlar arasında kullanılabilen kalıcı bir tanımlayıcıdır.
description

string

Medya öğesinin açıklaması. Bu bilgi, Google Fotoğraflar uygulamasındaki öğenin bilgi bölümünde kullanıcıya gösterilir. 1.000 karakterden kısa olmalıdır. Yalnızca kullanıcılar tarafından yazılan metinleri dahil edin. Açıklamalar bağlam eklemeli ve kullanıcıların medyayı anlamasına yardımcı olmalıdır. Dosya adları, etiketler ve diğer meta veriler gibi otomatik oluşturulan dizeleri eklemeyin.
productUrl

string

Medya öğesinin Google Fotoğraflar URL'si. Bu bağlantı, yalnızca oturum açmış olan kullanıcılara sunulur. Bir albüm aramasından alındığında, URL albümdeki öğeyi işaret eder.
baseUrl

string

Medya öğesinin baytları için bir URL. Bu şekilde kullanılmamalıdır. Parametreler, kullanılmadan önce bu URL'ye eklenmelidir. Desteklenen parametrelerin tam listesi için geliştirici belgelerine bakın. Örneğin, '=w2048-h1024', fotoğraf türündeki bir medya öğesinin boyutlarını 2048 piksel genişliği ve 1024 piksel yüksekliğinde olacak şekilde ayarlar.
mimeType

string

Medya öğesinin MIME türü. Örneğin, image/jpeg.
mediaMetadata

object (MediaMetadata)

Yükseklik, genişlik veya oluşturma zamanı gibi medya öğesiyle ilgili meta veriler.
contributorInfo

object (ContributorInfo)

Bu medya öğesini ekleyen kullanıcı hakkındaki bilgiler. Bunun yalnızca mediaItems.search, paylaşılan bir albümün kimliğiyle kullanıldığında dahil edildiğini unutmayın. Albümün uygulamanız tarafından oluşturulması ve paylaşım kapsamına sahip olmanız gerekir.
filename

string

Medya öğesinin dosya adı. Bu bilgi, Google Fotoğraflar uygulamasındaki öğenin bilgi bölümünde kullanıcıya gösterilir.

MediaMetadata

Bir medya öğesinin meta verileri.

JSON gösterimi 
{
  "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.
}
Alanlar
creationTime

string (Timestamp format)

Medya öğesinin ilk oluşturulduğu zaman (Google Fotoğraflar'a yüklendiği zaman değil).

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
width

string (int64 format)

Medya öğesinin orijinal genişliği (piksel cinsinden).
height

string (int64 format)

Medya öğesinin orijinal yüksekliği (piksel cinsinden).
Birlik alanı metadata. Medya öğesinin, temsil ettiği temel medya türüne özgü meta verileri. metadata yalnızca aşağıdakilerden biri olabilir:
photo

object (Photo)

Fotoğraf medya türü için meta veriler.
video

object (Video)

Video medya türünün meta verileri.

Fotoğraf

ISO, odak uzaklığı ve pozlama süresi gibi fotoğrafa özgü meta veriler. Bu alanların bazıları boş olabilir veya dahil edilmemiş olabilir.

JSON gösterimi 
{
  "cameraMake": string,
  "cameraModel": string,
  "focalLength": number,
  "apertureFNumber": number,
  "isoEquivalent": integer,
  "exposureTime": string
}
Alanlar
cameraMake

string

Fotoğrafın birlikte çekildiği kameranın markası.
cameraModel

string

Fotoğrafın birlikte çekildiği kameranın modeli.
focalLength

number

Fotoğrafın birlikte çekildiği kamera lensinin odak uzaklığı.
apertureFNumber

number

Fotoğrafın çekildiği kamera lensinin diyafram f sayısı.
isoEquivalent

integer

Fotoğrafın çekildiği kameranın ISO değeri.
exposureTime

string (Duration format)

Fotoğraf çekilirken kamera diyaframının pozlama süresi.

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

Video

Bir videoya özgü meta veriler (ör. fps ve işleme durumu). Bu alanlardan bazıları boş olabilir veya dahil edilmemiş olabilir.

JSON gösterimi 
{
  "cameraMake": string,
  "cameraModel": string,
  "fps": number,
  "status": enum (VideoProcessingStatus)
}
Alanlar
cameraMake

string

Videonun çekildiği kameranın markası.
cameraModel

string

Videonun çekildiği kameranın modeli.
fps

number

Videonun kare hızı.
status

enum (VideoProcessingStatus)

Videonun işleme durumu.

VideoProcessingStatus

Google Fotoğraflar'a yüklenen bir videonun işleme durumu.

Sıralamalar
UNSPECIFIED Video işleme durumu bilinmiyor.
PROCESSING Video işleniyor. Kullanıcı, Google Fotoğraflar uygulamasında bu videonun simgesini görür ancak video henüz oynatılamaz.
READY Videonuz işlendi ve görüntülemeye hazır. Önemli: HAZIR durumunda olmayan bir videoyu indirmeye çalıştığınızda indirme işlemi başarısız olabilir.
FAILED Bir sorun oluştuğu için video işlenemedi.

ContributorInfo

Medya öğesini ekleyen kullanıcıyla ilgili bilgiler. Bu bilgilerin yalnızca medya öğesi, uygulamanız tarafından oluşturulan bir paylaşılan albümdeyse ve paylaşım kapsamınız varsa dahil edildiğini unutmayın.

JSON gösterimi 
{
  "profilePictureBaseUrl": string,
  "displayName": string
}
Alanlar
profilePictureBaseUrl

string

Katkıda bulunan kullanıcının profil resminin URL'si.
displayName

string

Katkıda bulunan kişinin görünen adı.

Yöntemler

batchCreate

 Kullanıcının Google Fotoğraflar kitaplığında bir veya daha fazla medya öğesi oluşturur.

batchGet

 Belirtilen medya öğesi tanımlayıcıları için medya öğelerinin listesini döndürür.

get

 Belirtilen medya öğesi tanımlayıcısı için medya öğesini döndürür.

list

 Kullanıcının Google Fotoğraflar kitaplığındaki tüm medya öğelerini listeleyin.

patch

 Medya öğesini belirtilen id ile güncelleyin.
Kullanıcının Google Fotoğraflar kitaplığında medya öğelerini arar.