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ı. 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 URL 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ğ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 paylaşılan bir albümün kimliğiyle mediaItems.search kullanıldığında dahil edildiğini unutmayın. Albüm, uygulamanız tarafından oluşturulmuş olmalı ve paylaşım kapsamınız olmalıdır.
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).

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Ö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 özel meta verileri. metadata şunlardan yalnızca biri olabilir:
photo

object (Photo)

Bir fotoğraf medyası türünün meta verileri.
video

object (Video)

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

Fotoğraf

ISO, odak uzaklığı ve pozlama süresi gibi bir fotoğrafa özgü meta veriler. Bu alanlardan 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 açıklığı değeri.
isoEquivalent

integer

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

string (Duration format)

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

En fazla dokuz kesir basamağı olan 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şlenme durumu.

VideoProcessingStatus

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

Sıralamalar
UNSPECIFIED Videonun işleme durumu bilinmiyor.
PROCESSING Video işleniyor. Kullanıcı, Google Fotoğraflar uygulamasında bu videonun simgesini görür; ancak henüz oynatılamıyor.
READY Videonuz işlendi ve görüntülemeye hazır. Önemli: READY durumunda olmayan bir videoyu indirmeye çalışmak 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 paylaşılan bir albümde yer alıyorsa ve paylaşım kapsamına sahipseniz dahil edileceğ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

batchGet

get

list

patch

 Medya öğesini belirtilen id ile güncelleyin.