Library klien mempermudah akses Google Cloud API dari bahasa yang didukung. Meskipun Anda dapat menggunakan Google Cloud API secara langsung dengan membuat permintaan mentah ke server, library klien memberikan penyederhanaan yang secara signifikan mengurangi jumlah kode yang perlu Anda tulis.
Dokumen ini menjelaskan berbagai jenis library klien yang disediakan Google untuk Cloud API. Anda juga dapat mengetahui lebih lanjut library yang tersedia untuk produk atau bahasa pilihan Anda dalam dokumentasi produk atau bahasa.
Library Klien Cloud
Library Klien Cloud adalah opsi yang direkomendasikan untuk mengakses Cloud API secara terprogram, jika tersedia. Library Klien Cloud menggunakan model library klien terbaru dan:
- Berikan kode idiomatis dalam setiap bahasa untuk membuat Cloud API sederhana dan intuitif untuk digunakan.
- Berikan gaya yang konsisten di seluruh library klien untuk menyederhanakan penggunaan beberapa layanan Cloud.
- Menangani semua detail komunikasi tingkat rendah dengan server, termasuk autentikasi dengan Google.
- Dapat diinstal menggunakan alat pengelolaan paket yang sudah dikenal seperti
npmdanpip. - Dalam beberapa kasus, memberikan manfaat performa dengan menggunakan gRPC. Untuk informasi selengkapnya, lihat gRPC API.
Anda dapat menemukan petunjuk penginstalan dan materi referensi untuk Library Klien Cloud di halaman Library Klien untuk Cloud API yang Anda gunakan. Anda dapat menemukan link untuk memulai Library Klien Cloud dan dokumentasi referensinya di halaman Library Klien Cloud.
Coba sendiri
Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
Mulai secara gratisLibrary Klien Google API
Beberapa Google Cloud API tidak memiliki Library Klien Cloud yang tersedia dalam semua bahasa. Jika ingin menggunakan salah satu API ini dan tidak ada Library Klien Cloud untuk bahasa pilihan Anda, Anda masih dapat menggunakan gaya library klien sebelumnya, yang disebut Library Klien Google API. Anda juga dapat menggunakan library ini jika mengupgrade project yang sudah menggunakannya. Library ini:
- Hanya memberikan akses ke antarmuka REST API; gRPC tidak didukung.
- Memiliki kode antarmuka yang dibuat secara otomatis yang mungkin tidak seidiomatis dengan Library Klien Cloud.
- Menangani semua detail komunikasi tingkat rendah dengan server, termasuk autentikasi dengan Google.
- Dapat diinstal menggunakan alat pengelolaan paket yang sudah dikenal seperti
npmdanpip.
Library ini ditautkan di halaman Library Klien untuk Cloud API yang relevan.
Menggunakan platform seluler Firebase
Firebase adalah solusi Google untuk mem-build aplikasi di perangkat seluler. SDK ini menawarkan SDK dengan kode klien yang memungkinkan Anda mengakses Google Cloud API yang relevan dengan seluler dari aplikasi iOS, Android, dan Web. Untuk mengetahui informasi tentang Cloud API yang didukung dan cara memulai Firebase, lihat dokumentasi Firebase.
Menggunakan kode klien Anda sendiri
Jika Anda adalah developer berpengalaman dan library klien Google tidak memenuhi kebutuhan spesifik Anda, Anda dapat menulis kode kustom sendiri untuk mengakses API layanan tingkat rendah layanan secara langsung.
REST/HTTP API
Semua Cloud API mengekspos antarmuka JSON/REST tradisional yang sederhana. Jika perlu menulis kode kustom Anda sendiri untuk mengakses REST API secara langsung menggunakan library klien HTTP pihak ketiga, Anda dapat mengetahui lebih lanjut cara kerja Cloud API dengan versi dan implementasi HTTP yang berbeda di Panduan HTTP.
gRPC API
gRPC adalah sistem panggilan prosedur jarak jauh (RPC) open source, netral bahasa, dan netral platform yang awalnya dikembangkan di Google. Anda dapat mengetahuinya di grpc.io. Cloud API yang mendukung gRPC umumnya memiliki antarmuka REST dan RPC, sehingga klien API yang mendukung gRPC juga dapat menggunakan buffer protokol dan gRPC melalui HTTP2 untuk berkomunikasi dengan antarmuka RPC, bukan hanya menggunakan JSON melalui HTTP. Anda dapat mengetahui apakah API mengaktifkan gRPC dengan memeriksa bagian API dan Referensi.
Jika Cloud API mengaktifkan gRPC, Anda dapat membuat library klien gRPC Anda sendiri untuknya dalam bahasa apa pun yang didukung gRPC. Untuk melakukannya, Anda memerlukan definisi layanan buffer protokol API (biasanya tersedia dari repositori di GitHub). Kemudian, Anda dapat mengikuti petunjuk untuk bahasa pilihan Anda di grpc.io untuk membuat dan menggunakan klien.
Jika tidak ingin membuat kode gRPC sendiri, Anda tetap dapat memanfaatkan gRPC: semakin banyak Library Klien Cloud untuk API yang mengaktifkan gRPC menggunakan gRPC "di balik layar" untuk berkomunikasi dengan server Google. Hal ini jauh lebih efisien dalam hal throughput dan penggunaan CPU — mengakses API menggunakan gRPC dapat meningkatkan throughput per CPU hingga faktor 10 dibandingkan dengan JSON REST API. Google berencana mengupgrade Library Klien Cloud sebanyak mungkin ke gRPC; sementara itu, Anda masih akan mendapatkan semua keuntungan lainnya dari kode library klien Google.
Cara lain untuk mengakses Cloud API
Jika tidak ingin mengakses API secara terprogram, Anda dapat mengakses beberapa fungsi yang sama menggunakan alat di Google Cloud CLI atau menggunakan konsol Google Cloud.