API Images untuk layanan lama yang dipaketkan

API Images memberikan kemampuan untuk menyajikan gambar langsung dari Google Cloud Storage atau Blobstore, dan untuk memanipulasi gambar tersebut dengan cepat. Untuk melihat isi paket image, lihat referensi paket image.

Bucket Cloud Storage harus menggunakan Daftar Kontrol Akses yang mendetail agar API Images dapat berfungsi. Untuk bucket yang telah dikonfigurasi untuk akses level bucket yang seragam, Images API tidak akan dapat mengambil gambar di bucket tersebut dan menampilkan pesan error TransformationError. Jika bucket Anda dikonfigurasi dengan cara ini, Anda dapat menonaktifkan akses level bucket yang seragam.

API ini didukung untuk runtime generasi pertama dan dapat digunakan saat meng-upgrade ke runtime generasi kedua yang sesuai. Jika Anda meng-update ke runtime App Engine Go 1.12+, lihat panduan migrasi untuk mempelajari opsi migrasi Anda untuk layanan lama yang dipaketkan.

Format gambar

Layanan menerima data gambar dalam format JPEG, PNG, WEBP, GIF (termasuk GIF animasi), BMP, TIFF, dan ICO. Gambar yang diubah dapat ditampilkan dalam format JPEG, WEBP, dan PNG.

Jika format input dan format output berbeda, layanan akan mengonversi data input menjadi format output sebelum melakukan transformasi.

Catatan: Layanan Images tidak mendukung gambar TIFF multilapis.

Menyajikan dan mengubah ukuran gambar

Fungsi image.ServingURL memungkinkan Anda membuat URL khusus yang stabil untuk menyajikan thumbnail gambar yang sesuai untuk web.

Anda dapat menyimpan satu salinan gambar asli di Blobstore, lalu meminta URL per gambar berperforma tinggi yang dapat menyajikan gambar yang diubah ukurannya dan/atau dipangkas secara otomatis. Penyajian dari URL ini tidak akan menimbulkan beban penyajian dinamis atau CPU apa pun pada aplikasi Anda (meskipun bandwidth masih dikenakan biaya seperti biasa).

URL yang ditampilkan oleh fungsi selalu bersifat publik, tetapi tidak dapat ditebak; URL pribadi saat ini tidak didukung. Jika Anda ingin berhenti menyajikan URL, hapus URL tersebut menggunakan fungsi image.DeleteServingURL.

Jika Anda meneruskan nilai image.ServingURLOptions ke fungsi, nilai tersebut menampilkan URL yang dienkode dengan opsi tersebut. Jika Anda meneruskan nil, fungsi menampilkan URL default untuk gambar, misalnya:

http://lhx.ggpht.com/randomStringImageId

Anda dapat mengubah ukuran dan memangkas gambar secara dinamis dengan menentukan argumen dalam URL. Argumen yang tersedia adalah:

• =sxx di mana xx adalah bilangan bulat dengan rentang dari 0–2560 yang mewakili panjang sisi terpanjang gambar, dalam piksel. Misalnya, menambahkan =s32 akan mengubah ukuran gambar sehingga dimensi terpanjangnya adalah 32 piksel.
• =sxx-c di mana xx adalah bilangan bulat dengan rentang dari 0–2560 yang merepresentasikan ukuran gambar yang dipangkas dalam piksel, dan -c akan memberi tahu sistem untuk memangkas gambar.

Penting: Hanya argumen ubah ukuran dan pangkas yang tercantum di atas yang didukung. Menggunakan argumen lain dapat mengakibatkan kegagalan yang dapat menyebabkan gangguan.

# Resize the image to 32 pixels (aspect-ratio preserved)
http://lhx.ggpht.com/randomStringImageId=s32

# Crop the image to 32 pixels
http://lhx.ggpht.com/randomStringImageId=s32-c

Menyajikan gambar dari Cloud Storage menggunakan API Blobstore

Jika menggunakan Cloud Storage sebagai penyimpanan data dan menyajikan gambar menggunakan API Blobstore, Anda harus membuat kunci blob untuk objek Cloud Storage.

Catatan tentang penghapusan

Untuk berhenti menyajikan gambar yang disimpan di Cloud Storage atau Blobstore, panggil fungsi image.DeleteServingURL.

Hindari menghapus gambar secara langsung di Cloud Storage atau Blobstore karena hal ini dapat membuat gambar tetap dapat diakses melalui URL penyajian.

URL penyajian akan berhenti berfungsi jika aplikasi yang membuatnya dinonaktifkan atau dihapus, meskipun gambar yang mendasarinya tetap tersedia.