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. Ham baytları bir Google Sunucusu'na yükleyerek 1. adımla ilgili ayrıntılar için Medya yükleme başlıklı makaleye bakın.

Bu görüşme, 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. Medya öğesi varsayılan olarak kitaplığın veya albümün sonuna eklenir.

Bir albüm id ve konum tanımlıysa, medya öğesi belirtilen konumda albüme eklenir.

Görüşmede birden çok medya öğesi varsa 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. Aksi takdirde BAD REQUEST hatası verilir.

HTTP isteği

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

URL, gRPC Kod Dönüştürme 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 maksimum 50 medya öğesi.

albumPosition

object (AlbumPosition)

Albümün, medya öğelerinin eklendiği konumu. Belirtilmezse medya öğeleri albümün sonuna eklenir (varsayılan değere, yani LAST_IN_ALBUM değerine göre). Bu alan ayarlanırsa ve albumId belirtilmezse istek başarısız olur. Alanı ayarladığınızda ve paylaşılan albümün sahibi değilseniz 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:

Medya öğelerinin listesi oluşturuldu.

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

object (NewMediaItemResult)

Yalnızca çıkış. Medya öğelerinin listesi oluşturuldu.

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

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 simge, kullanıcıya Google Fotoğraflar uygulamasındaki bilgi bilgileri 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şturulan dizeleri eklemeyin.

Birlik alanı new_media_item_type. Yeni medya öğesi çeşitli türlerde olabilir. Bu, yükleme yoluna bağlıdır. Şu anda desteklenen yüklemeler yalnızca basit medya öğesi yolunu kullanıyor. new_media_item_type aşağıdakilerden yalnızca biri olabilir:
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, Google Fotoğraflar'da kullanıcıya gösterilir. Bu alan ayarlanırsa bayt yükleme işlemi sırasında belirtilen dosya adı yoksayılır. Dosya adı da dahil olmak üzere dosya adı 255 karakterden uzun olmamalıdır. Bu isteğe bağlı bir alandır.

YeniMedyaÖğeSonuçu

Yeni medya öğesi oluşturmanın 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 gerekiyorsa doldurulur.

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ılı bilgi için Durum başlıklı makaleye bakın.

mediaItem

object (MediaItem)

Medya öğesi, yükleme jetonuyla oluşturuldu. Hiç hata yoksa ve medya öğesi başarıyla oluşturulduysa doldurulur.