Kullanıcının Google Fotoğraflar kitaplığındaki bir veya daha fazla medya öğesini bir albüme ekler. Medya öğeleri ve albümler, geliştirici tarafından API aracılığıyla oluşturulmuş olmalıdır.
Medya öğeleri, albümün sonuna eklenir. Birden fazla medya öğesi sağlanırsa bu çağrıda 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ümlerde albümün kullanıcıya ait olması veya kullanıcının albüme ortak çalışan olarak 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
İstek gövdesi, aşağıdaki yapıya sahip verileri 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