Catatan rilis

Berlangganan ke catatan rilis ini.

Halaman ini diperbarui dengan setiap rilis baru Google Photos API. Log perubahan mencantumkan rilis berdasarkan tanggal dan menyertakan fitur baru, perbaikan bug, dan perubahan lainnya.

Dokumentasi dan panduan mengarah ke versi terbaru yang akan digunakan.

1 April 2025

Catatan

Rilis ini menerapkan perubahan yang telah diumumkan sebelumnya pada Photos API.

• Penghapusan beberapa cakupan dari Library API.
• Pembatasan beberapa metode agar hanya berfungsi dengan konten yang dibuat aplikasi.
• Kebijakan Data Pengguna dan Developer API Google Foto yang baru mulai berlaku menggantikan Kebijakan Penggunaan yang Dapat Diterima lama.

Untuk mengetahui detail selengkapnya, baca Pembaruan pada Google Photos API.

16 September 2024

Fitur

• Memperkenalkan Picker API baru untuk pemilihan foto yang aman dan mudah digunakan.

Catatan

Dalam rilis ini, kami mengumumkan perubahan utama pada Library API (berlaku mulai 31 Maret 2025).

• Library API hanya akan mengelola foto dan video yang dibuat oleh aplikasi Anda.
• Penghapusan cakupan photoslibrary.readonly, photoslibrary.sharing, dan photoslibrary.
• Pembatasan beberapa metode hanya untuk konten buatan aplikasi.

Detail lengkapnya ditampilkan di halaman Update pada Google Photos API.

27 Oktober 2022

Catatan

• Codelab "Mem-build aplikasi Berbagi Foto dengan Google Foto dan Flutter" tidak lagi tersedia. Tinjau contoh lainnya dan lihat kode contoh dalam panduan kami.

1 Juni 2022

Catatan

• Menambahkan praktik terbaik untuk mengupload guna membantu memperjelas proses upload, menyebutkan error umum dan cara menghindarinya, serta memberikan tips untuk meningkatkan efisiensi upload.

27 Oktober 2021

Fitur

• Program Partner Google Foto: peluncuran tingkat premier. Tingkat premier adalah serangkaian fitur API yang ditingkatkan yang memanfaatkan kecerdasan mesin Google Foto yang canggih.

29 September 2021

Fitur

• Opsi baru untuk mengurutkan penelusuran berdasarkan filter tanggal. Hasil dapat diurutkan dari yang terbaru atau terlama terlebih dahulu. Hal ini memungkinkan penelusuran yang lebih mudah dan meningkatkan efisiensi dengan memberikan hasil penelusuran yang lebih tepat.

21 Juli 2021

Fitur

• Parameter -no baru untuk URL dasar video untuk memuat thumbnail tanpa overlay tombol pemutaran. Secara default, thumbnail video dimuat dengan overlay tombol pemutaran. Parameter baru ini memberi Anda kontrol untuk menyembunyikan tombol pemutaran di thumbnail video.

Masalah yang telah diselesaikan

• Masalah 181282432: Thumbnail video selalu ditampilkan dengan overlay tombol pemutaran.

25 Mei 2021

Masalah yang telah diselesaikan

• Properti exposureTime tidak diisi untuk metadata photo di item media.

19 Mei 2021

Catatan

• Dokumentasi URL dasar untuk foto gerak telah diperbarui untuk memperjelas perilaku parameter =dv untuk foto gerak Android dan Live Photos iOS.

11 Februari 2021

Catatan

• Kebijakan Penggunaan yang Dapat Diterima telah diperbarui, dengan menambahkan konten tentang iklan dan meminimalkan penggunaan data.

7 Juli 2020

Fitur

• API telah diperbarui untuk mendukung kontrol berbagi baru di Google Foto. Kolom baru, isJoinable, kini ditampilkan sebagai bagian dari properti shareInfo untuk album bersama. API dapat menggabungkan pengguna ke album bersama jika isJoinable adalah true. Jika pemilik telah menonaktifkan berbagi link di album di Google Foto, isJoinable akan menjadi false, dan API tidak akan dapat bergabung dengan pengguna ke album tersebut.
• Masalah 111405623, 116379853, 117685011: Kini Anda dapat mengubah judul album dan foto sampul, dan mengubah deskripsi untuk item media yang dibuat aplikasi Anda. Minta cakupan otorisasi photoslibrary.edit.appcreateddata baru untuk akses update.

17 Februari 2020

Fitur

• Ukuran file upload maksimum foto telah ditingkatkan dari 75 MB menjadi 200 MB.
• Saat Anda mengupload file, jenis MIME kini harus ditentukan di tahap upload byte.
• Sekarang Anda menentukan nama file saat membuat item media, bukan saat mengupload byte media. Properti fileName baru di simpleMediaItem mendukung string UTF-8. Anda masih dapat menentukan nama file item media saat mengupload byte media, tetapi sebaiknya perbarui penerapan Anda.

Catatan

• Kebijakan Penggunaan yang Dapat Diterima telah diperbarui, dengan beberapa detail tambahan yang berfokus pada meminimalkan penggunaan dan penyimpanan data.
• Dokumentasi URL dasar telah diperbarui untuk menyertakan foto gerakan.

16 Agustus 2019

Fitur

• Masalah 131874809: Properti baru isOwned di shareInfo untuk mengidentifikasi apakah pengguna adalah pemilik album bersama. Detail selengkapnya tersedia di panduan developer media berbagi.

Masalah yang telah diselesaikan

• Masalah 131711405: Properti shareableUrl tidak ada dalam respons albums.list.
• Masalah 113870729: mediaItems.list terkadang menampilkan item media duplikat di batas halaman.
• Masalah 93428763: Kolom status untuk metadata video kini menampilkan VideoProcessingStatus video dengan kualitas tertinggi yang tersedia dengan benar.

12 Juni 2019

Fitur

• Masalah 110188560: Filter penelusuran baru untuk memilih item media yang telah ditandai sebagai favorit: FeatureFilter.
• Kategori konten baru untuk ContentFilter guna memfilter item media yang cocok dengan kategori tertentu: ARTS, CRAFTS, FASHION, HOUSES, GARDENS, FLOWERS, HOLIDAYS.

Catatan

• Memperbarui Panduan UX yang memberikan panduan tambahan untuk memberi nama project dan album.

7 Mei 2019

Codelab

• Codelab Baru: Mem-build aplikasi Berbagi Foto dengan Google Foto dan Flutter. Pelajari cara mem-build aplikasi berbagi foto menggunakan Google Photos Library API di Flutter. Lihat panduan contoh untuk mengetahui detailnya.

29 April 2019

Fitur

• Masalah 109505022: Panggilan baru untuk menambahkan dan menghapus item media yang ada ke album:

  • albums.batchAddMediaItems
  • albums.batchRemoveMediaItems

  Panggilan ini mendukung item media dan album yang telah dibuat oleh aplikasi Anda. Detail selengkapnya tersedia di panduan developer mengelola album.

• Panggilan REST untuk membuat item media mediaItems.batchCreate kini menampilkan status HTTP 207 MULTI-STATUS untuk keberhasilan sebagian jika beberapa item media tidak dapat dibuat. Detail selengkapnya tersedia di panduan developer Mengupload media.

Catatan

• Versi terbaru library klien menyertakan perubahan yang dapat menyebabkan gangguan. Class yang terkait dengan MediaItem, Album, dan DateRange telah dipindahkan ke paket khusus baru. Fungsinya tidak berubah, hanya lokasinya di library klien. Lihat catatan rilis untuk library klien Java (1.2.0) dan library klien PHP (1.2.0).

14 Februari 2019

Catatan

• Batas kuota baru untuk mengakses byte media dari URL dasar berlaku. Anda dapat memantau kuota ini di Konsol API Google.

Masalah yang telah diselesaikan

• Masalah 124355983: Error 500 saat memanggil mediaItems.get untuk beberapa item media bersama.

21 Januari 2019

Masalah yang telah diselesaikan

• Masalah 121998358: Properti isWriteable tidak ada dalam respons albums.create.

7 Januari 2019

Masalah yang telah diselesaikan

• Masalah 118464845: mediaItems.list menampilkan terlalu banyak halaman kosong.
• Masalah 111714379: mediaItems.search menampilkan setengah pageSize.

30 November 2018

Fitur

• Panggilan baru mediaItems.batchGet untuk mengambil beberapa item media berdasarkan ID-nya.
• Masalah 111279349: Panggilan baru sharedAlbums.leave untuk keluar dari album gabungan.
• Masalah 111279347: Panggilan baru albums.unshare untuk menandai album bersama sebagai pribadi.

Masalah yang telah diselesaikan

• Masalah 113978705: Deskripsi yang ditetapkan di mediaItems.batchCreate dikonversi menjadi entitas HTML.
• Masalah 114462217: Nama file tidak dapat ditetapkan untuk file video di mediaItems.batchCreate.
• Masalah 118475587: URL produk yang tidak valid ditampilkan untuk item media.
• Masalah 111862704: Error 403 saat mengakses URL dasar.
• Masalah 115932469: Upload gagal dengan error kuota.

6 September 2018

Fitur

• Library klien Java dan PHP kini tersedia.

Catatan

• Google Photos Library API telah memasuki ketersediaan umum. Terima kasih atas masukan dan permintaan fitur Anda selama periode pratinjau developer Library API.
• Lihat panduan baru untuk memulai dengan library klien Java dan PHP.
• Contoh cuplikan kode Java dan PHP telah ditambahkan ke panduan untuk menunjukkan penggunaan library klien.

5 September 2018

Fitur

• Panggilan baru sharedAlbums.get untuk mendapatkan album menggunakan shareToken.
• Properti baru isJoined di shareInfo untuk mengidentifikasi apakah pengguna telah bergabung ke album bersama.

Masalah yang telah diselesaikan

• Masalah 79321120: Properti mimeType tidak ada dalam respons mediaItems.batchCreate untuk item media video.
• Masalah 79319272: Properti seperti mediaMetadata, contributorInfo tidak ada dalam respons mediaItems.batchCreate.
• Masalah 110237685: Memperbaiki masalah upload file terkait CORS.
• Masalah 79318118: Urutan yang konsisten tidak dipertahankan saat mengupload beberapa item ke album dalam panggilan mediaItems.batchCreate.

Catatan

• Jika Anda menyimpan ID (seperti ID untuk album, item media, atau item pengayaan) sebelum 5 September 2018, ID tersebut tidak akan berfungsi lagi karena formatnya telah berubah. Anda harus mendapatkan ID baru untuk digunakan dalam aplikasi.
• Properti totalMediaItems dari resource album telah diganti namanya menjadi mediaItemsCount.
• Nilai maksimum parameter pageSize dalam panggilan mediaItems.list dan mediaItems.search telah diubah menjadi 100. Jumlah default item media yang ditampilkan saat parameter pageSize tidak ditentukan telah diubah menjadi 25.
• Panduan Mencantumkan konten library, Membagikan media, dan Mengakses item media diperbarui dengan fitur filter excludeNonAppCreatedData](/photos/library/guides/apply-filters#nonapp-created) yang dirilis pada 31 Juli 2018.

31 Juli 2018

Fitur

• Panggilan baru mediaItems.list untuk mencantumkan item media.
• Filter baru excludeNonAppCreatedData untuk menelusuri item atau mencantumkan album yang dibuat oleh aplikasi Anda.
• Parameter baru untuk mengakses gambar:
  • Masalah 79871479: Parameter pemangkasan c, untuk memangkas gambar ke dimensi yang tepat.
  • Masalah 110343547, Masalah 111228390: Parameter download d, untuk mendownload gambar asli.
• Panggilan sharedAlbums.join kini menampilkan album.
• Masalah 109655786: album kini berisi ID item media foto sampul, coverPhotoMediaItemId.
• Masalah 79656863: mediaItem kini berisi nama file item media, filename.

Masalah yang telah diselesaikan

• Masalah 79757390: Nama file tidak ditetapkan selama permintaan upload. Lihat kolom X-Goog-Upload-File-Namefile dan X-Goog-Upload-Protocol dalam panduan Upload media.
• Masalah 80182372: Upload yang dapat dilanjutkan menampilkan error. Lihat panduan Upload yang dapat dilanjutkan yang baru untuk protokol yang diperbarui.
• Masalah 79497397: Properti isWriteable tidak ada dalam respons albums.list.
• Masalah 111143493: Filter kategori konten PEOPLE menampilkan hasil yang tidak akurat.
• Masalah 111056278: Filter kategori konten BIRTHDAYS menampilkan error.

Rilis pratinjau - 8 Mei 2018

Rilis awal Library API.

Masalah umum

• GET mediaItem menampilkan error jika item media id yang diterimanya adalah untuk item media yang berasal dari album bersama dan tidak dimiliki oleh pengguna.
• Respons dari panggilan batchCreate tidak akan menampilkan mediaMetadata atau contributorInfo.
• Jika item media adalah video, panggilan batchCreate tidak akan menampilkan mimeType.
• batchCreate tidak mempertahankan urutan yang konsisten saat mengupload beberapa item.
• batchCreate tidak mendukung pengurutan (menambahkan position) saat membuat item media di album bersama sebagai pemilik album bersama. Secara default, album akan diputar dari akhir.