Update untuk Google Photos API

Diposting pada September 2024.

Halaman ini memberikan detail tentang perubahan spesifik yang dilakukan pada Google Foto Google Cloud Platform. Tinjau detail di halaman ini untuk memahami bagaimana metode dan cakupannya yang Anda gunakan. Anda dapat membaca selengkapnya tentang pengumuman ini perubahan di postingan blog terkait.

Catatan: Semua perubahan akan berlaku pada Maret 2025.

Library API: Dampak pada kasus penggunaan umum

Bagian berikut menjelaskan dampak perubahan mendatang terhadap penggunaan umum penggunaan.

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 penggunaan cakupan photoslibrary.appendonly, bukan cakupan photoslibrary. Tujuan photoslibrary cakupan sedang dihapus.

Mencantumkan, menelusuri, serta mengambil item media dan album

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 mengharuskan pengguna memilih foto atau album dari keseluruhan galeri foto, gunakan untuk Pemilih Google Foto Google Cloud API. Hal ini memberikan lingkungan cara yang mudah digunakan 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 (berbagi, membatalkan berbagi, mendapatkan, bergabung, keluar, dan cantumkan) akan menampilkan 403 PERMISSION_DENIED setelah 31 Maret 2025.

Yang dapat Anda lakukan:

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

Mengelola album yang dibuat aplikasi: pengayaan dan konten album

Apa yang berubah: photoslibrary.edit.appcreatedata sedang 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.appcreatedata untuk menyederhanakan proses otorisasi Anda.

Library API: Cakupan dan metode yang terpengaruh

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

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. Hal ini mencakup item media yang dipilih dengan Picker API dan ditambahkan ke galeri pengguna dengan Library API.	albums.create mediaItems.batchCreate	Cakupan yang tersisa: photoslibrary.appendonly Cakupan dihapus: photoslibrary photoslibrary.sharing
	albums.get albums.list mediaItems.batchGet mediaItems.get mediaItems.list mediaItems.search	Cakupan yang tersisa: photoslibrary.readonly.appcreatedata Cakupan 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 dihapus: photoslibrary.sharing Catatan: sharedAlbums.list dihapus karena tidak akan ada lagi album bersama yang dibuat oleh aplikasi Anda yang tersedia untuk dicantumkan.
Metode ini akan menambahkan photoslibrary.edit.appcreatedata. Metode ini sekarang hanya dapat digunakan dengan album dan item media yang dibuat oleh aplikasi Anda. Ini mencakup item media yang dipilih dengan Picker API dan ditambahkan ke library pengguna dengan Library API.	albums.addEnrichment albums.batchAddMediaItems	Cakupan yang tersisa: photoslibrary.appendonly photoslibrary.edit.appcreatedata Cakupan dihapus: photoslibrary
	albums.batchRemoveMediaItems	Cakupan yang tersisa: photoslibrary.edit.appcreatedata Cakupan yang dihapus: photoslibrary
Metode ini tetap tidak akan berubah.	albums.patch mediaItems.patch	Cakupan yang tersisa: photoslibrary.edit.appcreatedata Cakupan dihapus: Tidak ada

Pembaruan pada kebijakan Photos API

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

Pembaruan pada dokumentasi Photos API

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

• Situs Unified Photos API: Kami telah menggabungkan semua resource Photos API ke dalam satu lokasi yang nyaman (situs ini), memberikan pengalaman yang lebih baik bagi pengembang. 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 kemampuannya setelah periode penghentian. Di seluruh dokumentasi yang diperbarui, Anda akan menemukan label yang menyoroti setiap konten yang diubah atau dihapus, dengan link ke konten lama yang sesuai sebagai referensi selama migrasi.
• Dokumentasi Lama yang Dipertahankan: Kami mempertahankan Library API asli dokumentasi untuk developer yang memigrasikan integrasi yang ada. Jika Anda memulai project baru, gunakan dokumentasi yang diperbarui. Jika Anda memperbarui proyek yang sudah ada, lihat versi lama dan yang diperbarui dokumentasi lain 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. Kami mendorong siapa saja yang memiliki integrasi yang ada yang menggunakan Library API untuk memilih foto yang akan dimigrasikan Picker API sesegera mungkin.

Bagaimana pengaruhnya terhadap Library API?

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

Anda dapat meninjau kumpulan perubahan lengkap pada tabel di bagian atas 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: migrasikan ke Google Photos Picker API.
• Untuk fungsi lainnya: tinjau dokumentasi Library API yang diupdate untuk memahami perubahan dan mengidentifikasi fitur di aplikasi Anda yang mungkin tidak lagi tersedia. Anda mungkin perlu menyesuaikan fungsi aplikasi atau mengeksplorasi solusi alternatif untuk beberapa kasus penggunaan.

Apa itu Google Photos Picker API?

Picker API adalah cara baru dan aman bagi developer untuk memungkinkan pengguna memilih foto serta album dari Galeri Google Foto mereka, lalu kirimkan kembali dengan lancar ke aplikasi Anda. Picker API menawarkan kemampuan pemilihan foto yang andal, termasuk memilih item satu per satu, memilih semua item dalam album, dan menelusuri Google Photos Library.

Di mana saya dapat menemukan informasi selengkapnya tentang perubahan ini?

Halaman yang sedang Anda lihat memberikan ikhtisar dan ringkasan dari semua perubahan.

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

Postingan blog ini mengumumkan perubahan.

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

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