REST Resource: mediaItems

Kaynak: MediaItem

Google Fotoğraflar'da bir medya öğesinin (ör. fotoğraf veya video) gösterimi.

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ı. Oturumlar arasında bu medya öğesini tanımlamak için kullanılabilecek kalıcı bir tanımlayıcıdır.
description

string

Medya öğesinin açıklaması. Bu bilgi, kullanıcıya Google Fotoğraflar uygulamasındaki öğenin bilgi bölümünde 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. Kullanıcı bu bağlantıyı yalnızca oturum açmışsa kullanabilir. Bir albüm aramasından alındığında, URL albüm içindeki öğeyi işaret eder.
baseUrl

string

Medya öğesinin baytlarına yönlendiren bir URL. Bu değer olduğu gibi 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ğe ve 1024 piksel yüksekliğe ayarlar.
mimeType

string

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

object (MediaMetadata)

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

object (ContributorInfo)

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

string

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

MediaMetadata

Medya öğesi için meta veriler.

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ük ve en fazla dokuz kesir basamağı olan, 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).
Birleştirme alanı metadata. Temsil ettiği temel medya türüne özgü medya öğesi meta verileri. metadata şunlardan yalnızca biri olabilir:
photo

object (Photo)

Bir fotoğraf medya türüne ait meta veriler.
video

object (Video)

Video medya türüne ait meta veriler.

Fotoğraf

ISO, odak uzaklığı ve pozlama süresi gibi bir fotoğrafa özel 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 çekildiği kameranın markası.
cameraModel

string

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

number

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

number

Fotoğrafın çekildiği kamera lensinin diyafram açıklığı.
isoEquivalent

integer

Fotoğrafın çekildiği kameranın ISO'su.
exposureTime

string (Duration format)

Fotoğraf çekildiğinde kamera diyafram açıklığının pozlama süresi.

"s" ile biten ve en fazla dokuz kesir basamağı olan, saniye cinsinden bir süre. Örnek: "3.5s".

Video

Bir videoya özel meta veriler (ör. fps ve işleme durumu). Bu alanların 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şlenme 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üyor ancak video henüz oynatılamıyor.
READY Videonun işlenmesi tamamlandı ve video artık görüntülenmeye hazır. Önemli: HAZIR durumda olmayan bir videoyu indirme girişimi başarısız olabilir.
FAILED Bir sorun oluştuğu için video işlenemedi.

ContributorInfo

Medya öğesini ekleyen kullanıcı hakkında bilgiler. Bu bilgilerin yalnızca medya öğesi, uygulamanız tarafından oluşturulan paylaşılan bir albümdeyse ve paylaşım kapsamına sahipseniz ekleneceğ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ın 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 öğeleri 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 listeleme.

patch

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