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 tentang 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 di setiap bahasa untuk membuat Cloud API sederhana dan intuitif untuk digunakan.
- Memberikan gaya yang konsisten di seluruh library klien untuk menyederhanakan pekerjaan dengan beberapa layanan Cloud.
- Menangani semua detail komunikasi tingkat rendah dengan server, termasuk mengautentikasi dengan Google.
- Dapat diinstal menggunakan alat pengelolaan paket yang sudah dikenal, seperti
npmdanpip. - Dalam beberapa kasus, memberi Anda 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.
Cobalah 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 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 berikan akses ke antarmuka REST API; gRPC tidak didukung.
- Memiliki kode antarmuka yang dibuat secara otomatis yang mungkin tidak idiomatis seperti Library Klien Cloud.
- Menangani semua detail komunikasi tingkat rendah dengan server, termasuk mengautentikasi 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 di seluruh Google untuk membangun aplikasi di perangkat seluler. Cloud API menawarkan SDK dengan kode klien yang memungkinkan Anda mengakses 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 lebih rendah dari layanan tersebut secara langsung.
API REST/HTTP
Semua Cloud API mengekspos antarmuka JSON/REST tradisional yang sederhana. Jika Anda perlu menulis kode kustom Anda sendiri untuk langsung mengakses REST API menggunakan library klien HTTP pihak ketiga, Anda dapat mengetahui lebih lanjut cara kerja Cloud API dengan berbagai versi dan implementasi HTTP di Panduan HTTP.
gRPC API
gRPC adalah sistem panggilan prosedur jarak jauh (RPC) yang tidak tergantung bahasa, tidak tergantung platform, open source, yang awalnya dikembangkan di Google. Anda dapat mengetahuinya di grpc.io. Cloud API yang mendukung gRPC umumnya memiliki antarmuka REST dan RPC, jadi bukan hanya menggunakan JSON melalui HTTP untuk berkomunikasi dengan antarmuka REST, klien API yang mendukung gRPC juga dapat menggunakan buffering protokol dan gRPC melalui HTTP2 untuk berkomunikasi dengan antarmuka RPC. Anda dapat mengetahui apakah API diaktifkan oleh gRPC dengan memeriksa bagian API dan Referensinya.
Jika Cloud API mendukung gRPC, Anda dapat membuat library klien gRPC Anda sendiri dalam bahasa yang didukung gRPC. Untuk melakukannya, Anda memerlukan definisi layanan protocol buffer 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 masih dapat memanfaatkan gRPC: semakin banyak Library Klien Cloud untuk API yang mendukung gRPC menggunakan "di balik layar" gRPC 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 10 kali lipat dibandingkan dengan JSON REST API. Google berencana mengupgrade sebanyak mungkin Library Klien Cloud ke gRPC; sementara itu, Anda akan tetap 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.