Update untuk Google Photos API

Diposting September 2024.

Halaman ini memberikan detail tentang perubahan spesifik yang dilakukan pada API Google Foto. Tinjau detail di halaman ini untuk memahami pengaruhnya terhadap metode dan cakupan yang Anda gunakan. Anda dapat membaca pengumuman perubahan ini lebih lanjut di postingan blog terkait.

Library API: Dampak pada kasus penggunaan umum

Bagian berikut menjelaskan secara mendetail pengaruh perubahan mendatang terhadap kasus penggunaan umum.

Mengupload item media dan membuat album

Yang berubah: Tidak ada perubahan. Anda dapat terus mengupload item media dan membuat album menggunakan cakupan photoslibrary.appendonly.

Yang dapat Anda lakukan:

Jika aplikasi Anda mengupload item media atau membuat album, pastikan Anda menggunakan cakupan photoslibrary.appendonly, bukan cakupan photoslibrary. Cakupan photoslibrary sedang dihapus.

Mencantumkan, menelusuri, dan mengambil item dan album media

Yang berubah: Anda kini hanya dapat mencantumkan, menelusuri, dan mengambil album serta item media yang dibuat oleh aplikasi Anda.

Yang dapat Anda lakukan:

• Jika aplikasi Anda memerlukan pengguna untuk memilih foto atau album dari seluruh library mereka, gunakan Google Photos Picker API baru. Hal ini memberikan cara yang aman dan mudah digunakan bagi pengguna untuk memberikan akses ke konten tertentu.
• Jika aplikasi Anda mengandalkan akses ke seluruh library pengguna, Anda mungkin perlu mengevaluasi ulang aplikasi atau mempertimbangkan pendekatan alternatif.

Berbagi dan album bersama

Yang berubah: Album bersama dan fungsi API terkait (bagikan, hapus pembagian, dapatkan, gabung, keluar, dan daftar) akan menampilkan 403 PERMISSION_DENIED setelah 31 Maret 2025.

Yang dapat Anda lakukan:

Arahkan pengguna ke aplikasi Google Foto untuk mengelola berbagi sendiri. Anda dapat memberikan petunjuk atau deep link yang jelas dalam aplikasi untuk memandu mereka.

Mengelola album yang dibuat aplikasi: pengayaan dan konten album

Yang berubah: photoslibrary.edit.appcreateddata ditambahkan ke tiga metode berikut untuk konsistensi konseptual:

• albums.addEnrichment
• albums.batchAddMediaItems
• albums.batchRemoveMediaItems

Yang dapat Anda lakukan:

• Jika aplikasi Anda sudah menggunakan metode ini, pertimbangkan untuk mengadopsi cakupan photoslibrary.edit.appcreateddata untuk menyederhanakan proses otorisasi Anda.

Library API: Cakupan dan metode yang terpengaruh

Sebagai bagian dari perubahan pada Google Photos API, kami telah melakukan update berikut.

Seperti yang ditampilkan di halaman Otorisasi yang diperbarui, cakupan berikut akan dihapus dari Library API setelah 31 Maret 2025:

• photoslibrary.readonly
• photoslibrary.sharing
• photoslibrary

Cakupan berikut akan tetap ada:

• photoslibrary.appendonly
• photoslibrary.readonly.appcreateddata
• photoslibrary.edit.appcreateddata

Tabel ini menjelaskan metode dan cakupan Library API tertentu yang terpengaruh.

Pembaruan	Metode	Cakupan
Metode ini kini hanya dapat digunakan dengan album dan item media yang dibuat oleh aplikasi Anda.	albums.create mediaItems.batchCreate	Cakupan yang tersisa: photoslibrary.appendonly Cakupan yang dihapus: photoslibrary photoslibrary.sharing
	albums.get albums.list mediaItems.batchGet mediaItems.get mediaItems.list mediaItems.search	Cakupan yang tersisa: photoslibrary.readonly.appcreateddata Cakupan yang dihapus: photoslibrary photoslibrary.readonly
Metode ini tidak akan tersedia lagi.	albums.share albums.unshare sharedAlbums.get sharedAlbums.join sharedAlbums.leave sharedAlbums.list	Cakupan yang tersisa: Tidak ada Cakupan yang dihapus: photoslibrary.sharing
Metode ini akan memiliki photoslibrary.edit.appcreateddata yang ditambahkan. Metode ini kini hanya dapat digunakan dengan album dan item media yang dibuat oleh aplikasi Anda.	albums.addEnrichment albums.batchAddMediaItems	Cakupan yang tersisa: photoslibrary.appendonly photoslibrary.edit.appcreateddata Cakupan yang dihapus: photoslibrary
	albums.batchRemoveMediaItems	Cakupan yang tersisa: photoslibrary.edit.appcreateddata Cakupan yang dihapus: photoslibrary
Metode ini tidak akan berubah.	albums.patch mediaItems.patch	Cakupan yang tersisa: photoslibrary.edit.appcreateddata Cakupan yang dihapus: Tidak ada

Pembaruan pada kebijakan Photos API

Kebijakan penggunaan yang dapat diterima saat ini akan diganti setelah 31 Maret 2025 dengan Kebijakan Data Pengguna dan Developer API Google Foto yang baru. Kebijakan baru kini tersedia untuk pratinjau.

Pembaruan pada dokumentasi Photos API

Kami telah melakukan perubahan signifikan pada dokumentasi Photos API untuk mencerminkan update mendatang dan mendukung pengalaman pengembangan Anda:

• Situs Photos API Terpadu: Kami telah menggabungkan semua referensi Photos API ke dalam satu lokasi (situs ini), sehingga memberikan pengalaman yang disederhanakan bagi developer. Di sini, Anda akan menemukan:
  • Referensi Terpusat: Petunjuk penyiapan dan panduan penggunaan umum yang digabungkan, serta informasi dukungan dan kebijakan yang digabungkan untuk Picker API dan Library API.
  • Situs API khusus: Setiap situs dengan panduan mendetail, dokumentasi referensi, dan contoh kode untuk Picker API dan Library API
• Konten Library API yang Diperbarui: Dokumentasi Library API telah direvisi untuk mencerminkan kemampuan Library API setelah periode penghentian.
• Dokumentasi Lama yang Dipertahankan: Kami telah mempertahankan dokumentasi Library API asli untuk developer yang perlu memigrasikan integrasi yang ada. Jika Anda memulai project baru, gunakan dokumentasi yang diperbarui. Jika Anda memperbarui project yang ada, lihat dokumentasi lama dan yang diperbarui sesuai kebutuhan selama migrasi.

Pertanyaan umum (FAQ)

Apa yang berubah pada Google Photos API?

Kami memperkenalkan Google Photos Picker API baru untuk pemilihan foto yang aman dan mengupdate Library API yang ada untuk berfokus pada pengelolaan foto dan video yang dibuat oleh aplikasi Anda.

Kapan perubahan ini akan diterapkan?

Perubahan ini akan berlaku pada 31 Maret 2025. Sebaiknya semua orang dengan integrasi yang ada yang menggunakan Library API untuk pengambilan foto bermigrasi ke Picker API sesegera mungkin.

Bagaimana pengaruhnya terhadap Library API?

Cakupan photoslibrary.readonly, photoslibrary.sharing, dan photoslibrary akan dihapus. Panggilan API yang hanya mengandalkan cakupan ini akan menampilkan 403 PERMISSION_DENIED setelah 31 Maret 2025. Beberapa panggilan lainnya akan dibatasi agar hanya berfungsi dengan foto dan video yang dibuat oleh aplikasi Anda.

Anda dapat meninjau kumpulan lengkap perubahan di tabel cakupan dan metode yang terpengaruh di halaman ini.

Apa yang harus saya lakukan jika aplikasi saya saat ini menggunakan cakupan atau metode yang terpengaruh?

Jika aplikasi Anda menggunakan salah satu cakupan atau metode yang terpengaruh, sebaiknya lakukan langkah-langkah berikut:

• Untuk pemilihan foto: bermigrasi ke Google Photos Picker API.
• Untuk fungsi lain: tinjau dokumentasi Library API yang diperbarui untuk memahami perubahan dan mengidentifikasi fitur di aplikasi Anda yang mungkin tidak lagi tersedia. Anda mungkin perlu menyesuaikan fungsi aplikasi atau mempelajari solusi alternatif untuk beberapa kasus penggunaan.

Apa itu Google Photos Picker API?

Picker API adalah cara baru yang aman bagi developer untuk mengizinkan pengguna memilih foto dan video dari Library Google Foto mereka, dan mengirimkannya kembali ke aplikasi Anda dengan lancar.

Di mana saya dapat menemukan informasi selengkapnya tentang perubahan ini?

Halaman yang saat ini Anda lihat memberikan ringkasan dan ringkasan semua perubahan.

Dokumentasi lainnya di situs kami telah diperbarui untuk mencerminkan API yang diperbarui.

Postingan blog ini mengumumkan perubahan tersebut.

Bagaimana jika saya memiliki pertanyaan lebih lanjut atau memerlukan bantuan untuk memigrasikan aplikasi saya?

Jika Anda memiliki pertanyaan tentang dokumentasi developer, tinjau halaman dukungan kami untuk mengetahui detail tambahan tentang cara mendapatkan bantuan.