Kullanıcının Google Fotoğraflar kitaplığındaki bir veya daha fazla medya öğesini bir albüme ekler. Medya öğeleri ve albümler, API aracılığıyla geliştirici tarafından oluşturulmuş olmalıdır.
Medya öğeleri albümün sonuna eklenir. Birden fazla medya öğesi verilirse bunlar bu görüşmede belirtilen sırayla eklenir.
Her albüm en fazla 20.000 medya öğesi içerebilir.
Yalnızca kullanıcının kitaplığındaki medya öğeleri albüme eklenebilir. Paylaşılan albümler için, albümün ya kullanıcıya ait olması ya da kullanıcının ortak çalışan olarak albüme katılmış olması gerekir.
Kısmi başarı desteklenmez. Geçersiz bir medya öğesi veya albüm belirtilirse isteğin tamamı başarısız olur.
HTTP isteği
POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:batchAddMediaItems
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
albumId |
Zorunlu. Medya öğelerinin eklendiği |
İstek içeriği
İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:
JSON gösterimi |
---|
{ "mediaItemIds": [ string ] } |
Alanlar | |
---|---|
mediaItemIds[] |
Zorunlu. Eklenecek |
Yanıt gövdesi
Başarılı olursa yanıt gövdesi boş olur.
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