Method: mediaItems.batchCreate

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

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

Bu, medya öğesi oluşturmanın ikinci adımıdır. İşlenmemiş baytları bir Google Sunucusuna yükleme ile ilgili 1. Adımdaki ayrıntılar için Medya yükleme bölümünü inceleyin.

Bu çağrı, medya öğesini kitaplığa ekler. Bir albüm (id) belirtilirse arama, medya öğesini albüme de ekler. Her albüm en fazla 20.000 medya öğesi içerebilir. Varsayılan olarak medya öğesi, kitaplığın veya albümün sonuna eklenir.

Hem albüm id hem de konum tanımlandıysa medya öğesi albüme belirtilen konumda eklenir.

Arama birden fazla medya öğesi içeriyorsa bunlar belirtilen konuma eklenir. Sahibi olmadığınız paylaşılan bir albümde medya öğesi oluşturuyorsanız medya öğesini konumlandırmanıza izin verilmez. Bunu yapmak BAD REQUEST hatasıyla sonuçlanır.

HTTP isteği

POST https://photoslibrary.googleapis.com/v1/mediaItems:batchCreate

URL, gTB Kod Geçişi söz dizimini kullanır.

İstek metni

İstek gövdesi aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi
{
  "albumId": string,
  "newMediaItems": [
    {
      object (NewMediaItem)
    }
  ],
  "albumPosition": {
    object (AlbumPosition)
  }
}
Alanlar
albumId

string

Medya öğelerinin eklendiği albümün tanımlayıcısı. Medya öğeleri de kullanıcının kitaplığına eklenir. Bu isteğe bağlı bir alandır.

newMediaItems[]

object (NewMediaItem)

Zorunlu. Oluşturulacak medya öğelerinin listesi. Arama başına en fazla 50 medya öğesi.

albumPosition

object (AlbumPosition)

Albümün, medya öğelerinin eklendiği konumu. Belirtilmemesi halinde medya öğeleri, albümün sonuna eklenir (varsayılan değere göre, yani LAST_IN_ALBUM). Bu alan ayarlanırsa ve albumId belirtilmemişse istek başarısız olur. Alanı ayarladığınız ve paylaşılan albümün sahibi olmadığınızda da istek başarısız olur.

Yanıt metni

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

Oluşturulan medya öğelerinin listesi.

JSON gösterimi
{
  "newMediaItemResults": [
    {
      object (NewMediaItemResult)
    }
  ]
}
Alanlar
newMediaItemResults[]

object (NewMediaItemResult)

Yalnızca çıkış. Oluşturulan medya öğelerinin listesi.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.sharing

YeniMedyaÖğesi

Bir kullanıcının Google Fotoğraflar hesabında oluşturulan yeni medya öğesi.

JSON gösterimi
{
  "description": string,
  "simpleMediaItem": {
    object (SimpleMediaItem)
  }
}
Alanlar
description

string

Medya öğesinin açıklaması. Bu, 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 ekleyin. 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 olarak oluşturulmuş dizeleri eklemeyin.

simpleMediaItem

object (SimpleMediaItem)

Dahil edilen uploadToken aracılığıyla yüklenen yeni medya öğesi.

BasitMedyaÖğesi

Google Fotoğraflar'da yükleme jetonu aracılığıyla oluşturulacak basit medya öğesi.

JSON gösterimi
{
  "uploadToken": string,
  "fileName": string
}
Alanlar
uploadToken

string

Google'a yüklenen medya baytlarını tanımlayan jeton.

fileName

string

Medya öğesinin uzantısına sahip dosya adı. Bu ad kullanıcıya Google Fotoğraflar'da gösterilir. Bu alan ayarlanırsa bayt yükleme işlemi sırasında belirtilen dosya adı yoksayılır. Dosya uzantısı da dahil dosya adı 255 karakterden uzun olamaz. Bu isteğe bağlı bir alandır.

YeniMedyaÖğeSonucu

Yeni medya öğesi oluşturmanın sonucu.

JSON gösterimi
{
  "uploadToken": string,
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
Alanlar
uploadToken

string

Bu yeni medya öğesini oluşturmak için kullanılan yükleme jetonu.

status

object (Status)

Bu medya öğesinin oluşturulması sırasında bir hata oluştuysa bu alan, hatayla ilgili bilgilerle doldurulur. Bu alanla ilgili ayrıntılar için Durum başlıklı makaleyi inceleyin.

mediaItem

object (MediaItem)

Yükleme jetonuyla oluşturulan medya öğesi. Bu dosya, hata oluşmadıysa ve medya öğesi başarıyla oluşturulduysa doldurulur.