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 metin, Google Fotoğraflar uygulamasında öğ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 ekleyin. Açıklamalar bağlam bilgisi eklemeli ve kullanıcıların medyayı anlamasına yardımcı olmalıdır. Dosya adları, etiketler ve diğer meta veriler gibi otomatik olarak oluşturulmuş dizeler eklemeyin.
productUrl

string

Medya öğesinin Google Fotoğraflar URL'si. Bu bağlantıyı yalnızca oturumu açık olan kullanıcılar kullanabilir. Bir albüm aramasından alındığında URL, albümdeki öğeyi gösterir.
baseUrl

string

Medya öğesinin baytlarına ait 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şlik ve 1024 piksel yükseklik olacak şekilde ayarlar.
mimeType

string

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

object (MediaMetadata)

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

object (ContributorInfo)

Bu medya öğesini ekleyen kullanıcıyla ilgili bilgiler. Bunun yalnızca mediaItems.search, paylaşılan bir albümün kimliğiyle 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).

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
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ü için meta veriler.

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 ç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 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 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ş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 Videonun işlenmesi tamamlandı ve video izlenmeye 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

batchGet

get

list

patch

 Medya öğesini belirtilen id ile güncelleyin.