Method: mediaItems.batchCreate

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. Ham baytları bir Google sunucusuna yüklemeyle ilgili 1. adım hakkında ayrıntılı bilgi için Medya yükleme başlıklı makaleyi inceleyin.

Bu çağrı, medya öğesini kitaplığa ekler. Bir albüm id belirtilirse medya öğesi de albüme eklenir. Her albümde en fazla 20.000 medya öğesi bulunabilir. Medya öğesi varsayılan olarak kitaplığın veya albümün sonuna eklenir.

Hem albüm id hem de konum tanımlanmışsa medya öğesi, albüme belirtilen konuma eklenir.

Arama birden fazla medya öğesi içeriyorsa bu öğeler belirtilen konuma eklenir. Sahibi olmadığınız bir ortak albümde medya öğesi oluşturuyorsanız medya öğesini konumlandırmanıza izin verilmez. Aksi takdirde BAD REQUEST hatası oluşur.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte 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ıdır. 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. Görüşme başına en fazla 50 medya öğesi.
albumPosition

object (AlbumPosition)

Medya öğelerinin eklendiği albümdeki konum. Belirtilmemişse medya öğeleri albümün sonuna eklenir (varsayılan değere göre, yani LAST_IN_ALBUM). Bu alan ayarlanmışsa ve albumId belirtilmemişse istek başarısız olur. Alanı ayarlayan kullanıcı, paylaşılan albümün sahibi değilse de istek başarısız olur.

Yanıt gövdesi

Oluşturulan medya öğelerinin listesi.

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

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

NewMediaItem

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

JSON gösterimi 
{
  "description": string,

  // Union field new_media_item_type can be only one of the following:
  "simpleMediaItem": {
    object (SimpleMediaItem)
  }
  // End of list of possible types for union field new_media_item_type.
}
Alanlar
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.
Birlik alanı new_media_item_type. Yeni medya öğesi, yükleme yoluna bağlı olarak çeşitli türlerde olabilir. Şu anda desteklenen yüklemeler yalnızca basit medya öğesi yolunu kullanır. new_media_item_type yalnızca aşağıdakilerden biri olabilir:
simpleMediaItem

object (SimpleMediaItem)

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

SimpleMediaItem

Yükleme jetonu aracılığıyla Google Fotoğraflar'da oluşturulacak basit bir 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ını içeren dosya adı. Bu bilgi, Google Fotoğraflar'da kullanıcıya gösterilir. Bu alan ayarlanmışsa bayt yükleme işlemi sırasında belirtilen dosya adı yoksayılır. Dosya uzantısı dahil dosya adı 255 karakterden uzun olmamalıdır. Bu isteğe bağlı bir alandır.

NewMediaItemResult

Yeni bir medya öğesi oluşturma sonucu.

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

string

Bu yeni (basit) medya öğesini oluşturmak için kullanılan yükleme jetonu. Yalnızca medya öğesi basitse ve tek bir yükleme jetonu gerektiriyorsa doldurulur.
status

object (Status)

Bu medya öğesi oluşturulurken bir hata oluştuysa bu alan hatayla ilgili bilgilerle doldurulur. Bu alanla ilgili ayrıntılar için Durum bölümüne bakın.
mediaItem

object (MediaItem)

Yükleme jetonuyla oluşturulan medya öğesi. Hata oluşmazsa ve medya öğesi başarıyla oluşturulursa doldurulur.