- HTTP isteği
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- NewMediaItem
- SimpleMediaItem
- NewMediaItemResult
- Deneyin.
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 ayrıntılar için Medya yükleme konusuna bakın.
Bu çağrı, medya öğesini kitaplığa ekler. Bir albüm id
belirtilirse çağrı, 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ımlandıysa medya öğesi albüme belirtilen konuma eklenir.
Çağrı birden fazla medya öğesi içeriyorsa bu öğeler belirtilen konuma eklenir. Sahibi olmadığınız paylaşılan bir albümde medya öğesi oluşturuyorsanız medya öğesini konumlandırmanıza izin verilmez. Bu işlem, BAD REQUEST
hatasına neden olur.
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
İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:
JSON gösterimi |
---|
{ "albumId": string, "newMediaItems": [ { object ( |
Alanlar | |
---|---|
albumId |
Medya öğelerinin eklendiği albümün tanımlayıcısı. Medya öğeleri kullanıcının kitaplığına da eklenir. Bu alan isteğe bağlıdır. |
newMediaItems[] |
Zorunlu. Oluşturulacak medya öğelerinin listesi. Arama başına maksimum 50 medya öğesi. |
albumPosition |
Albümde medya öğelerinin eklendiği konum. Belirtilmezse medya öğeleri albümün sonuna eklenir (varsayılan değere göre, yani |
Yanıt gövdesi
Medya öğeleri listesi oluşturuldu.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{
"newMediaItemResults": [
{
object ( |
Alanlar | |
---|---|
newMediaItemResults[] |
Yalnızca çıkış. Medya öğeleri 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
NewMediaItem
Kullanıcının Google Fotoğraflar hesabında oluşturulan yeni medya öğesi.
JSON gösterimi |
---|
{ "description": string, // Union field |
Alanlar | |
---|---|
description |
Medya öğesinin açıklaması. Bu bilgi, 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 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. |
Birleştirme alanı new_media_item_type . Yeni medya öğesi çeşitli farklı türlerde olabilir. Bu, yükleme yoluna bağlıdır. Şu anda desteklenen yüklemeler yalnızca basit medya öğesi yolunu kullanır. new_media_item_type şunlardan yalnızca biri olabilir: |
|
simpleMediaItem |
Eklenen |
SimpleMediaItem
Google Fotoğraflar'da yükleme jetonu aracılığıyla oluşturulan basit bir medya öğesidir.
JSON gösterimi |
---|
{ "uploadToken": string, "fileName": string } |
Alanlar | |
---|---|
uploadToken |
Google'a yüklenen medya baytlarını tanımlayan jeton. |
fileName |
Medya öğesinin uzantısını içeren 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 adı (dosya uzantısı dahil) 255 karakterden uzun olmamalıdır. Bu alan isteğe bağlıdır. |
NewMediaItemResult
Yeni bir medya öğesi oluşturmanın sonucu.
JSON gösterimi |
---|
{ "uploadToken": string, "status": { object ( |
Alanlar | |
---|---|
uploadToken |
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 |
Söz konusu medya öğesi oluşturulurken bir hata meydana gelirse bu alan hatayla ilgili bilgilerle doldurulur. Bu alanla ilgili ayrıntılar için Durum bölümüne bakın. |
mediaItem |
Yükleme jetonuyla oluşturulan medya öğesi. Bu alan, herhangi bir hata oluşmadıysa ve medya öğesi başarıyla oluşturulduysa doldurulur. |