Library klien memungkinkan Anda mengakses Google Cloud API secara terprogram dengan lebih sedikit kode boilerplate dengan menangani autentikasi dan komunikasi server tingkat rendah. Dokumen ini menjelaskan metode berikut untuk berinteraksi dengan APIGoogle Cloud :
- Library Klien Cloud (direkomendasikan)
- Library Klien Google API
- Platform pengembangan Firebase
- Kode klien Anda sendiri
Untuk menemukan informasi library klien untuk produk Google Cloud tertentu, lihat bagian library klien dalam dokumentasi produk tersebut.
Library Klien Cloud
Meskipun Anda dapat menggunakan API Google Cloud secara langsung dengan membuat permintaan mentah ke server, Library Klien Cloud memberikan penyederhanaan yang secara signifikan mengurangi jumlah kode yang perlu Anda tulis. Library Klien Cloud adalah opsi yang direkomendasikan untuk mengakses Cloud API secara terprogram, karena menggunakan model library klien terbaru dan:
- Menyediakan kode idiomatis dalam setiap bahasa untuk membuat Google Cloud API intuitif untuk digunakan.
- Menyediakan gaya yang konsisten di seluruh library klien untuk menyederhanakan penggunaan beberapa Google Cloud layanan.
- 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, memberikan manfaat performa dengan menggunakan gRPC. Untuk mengetahui informasi selengkapnya, lihat gRPC API.
Petunjuk penginstalan dan materi referensi untuk Library Klien Cloud bergantung pada API Google Cloud tertentu dan bahasa pemrograman yang Anda gunakan. Untuk menemukan informasi ini, lihat dokumentasi untuk produk Google Cloud tertentu. Sebagian besar produk menyertakan bagian "Library Klien" dalam dokumentasinya, yang memberikan panduan khusus bahasa, langkah-langkah penginstalan, dan link ke referensi API mendetail.
Anda dapat menemukan dokumentasi untuk produk tertentu dengan menjelajahi library APIGoogle Cloud .
Coba sendiri
Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga akan mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
Mulai secara gratisLibrary Klien Google API
Jika Library Klien Cloud tidak tersedia untuk bahasa pilihan Anda untuk API tertentu, Anda dapat menggunakan Library Klien Google API. Library ini adalah jenis library klien sebelumnya yang disediakan oleh Google.
Anda juga dapat menggunakan library ini jika mengupgrade project yang sudah menggunakannya. Library ini:
- Berikan akses hanya ke antarmuka REST API; gRPC tidak didukung.
- Memiliki kode antarmuka yang dibuat otomatis yang mungkin tidak seidiomatik 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.
Menggunakan platform pengembangan Firebase
Firebase adalah platform layanan Google yang dirancang untuk mendukung seluruh siklus proses pengembangan aplikasi Anda. Firebase menyediakan SDK lintas platform untuk membantu Anda dan agen AI membangun dan menjalankan aplikasi untuk platform Apple, Android, web, Flutter, Unity, dan C++.
Untuk mengetahui informasi tentang API yang didukung Google Cloud dan cara mulai menggunakan Firebase, lihat dokumentasi Firebase.
Menggunakan kode klien Anda sendiri
Jika Anda adalah developer berpengalaman dan Library Klien Cloud tidak memenuhi kebutuhan spesifik Anda, Anda dapat menulis kode kustom sendiri untuk mengakses API layanan tingkat bawah secara langsung.
REST/HTTP API
Semua Google Cloud API mengekspos antarmuka JSON/REST. Jika Anda perlu menulis kode kustom sendiri untuk mengakses REST API secara langsung menggunakan library klien HTTP pihak ketiga, Anda dapat mengetahui lebih lanjut cara kerja API Google Cloud dengan berbagai versi dan penerapan HTTP di Panduan HTTP.
gRPC API
gRPC adalah sistem panggilan prosedur jarak jauh (RPC) open source yang netral bahasa dan platform, yang awalnya dikembangkan di Google. Anda dapat mengetahui lebih lanjut di grpc.io. API Google Cloud yang mendukung gRPC umumnya memiliki antarmuka REST dan RPC, sehingga daripada hanya menggunakan JSON melalui HTTP untuk berkomunikasi dengan antarmuka REST, klien API yang mendukung gRPC juga dapat menggunakan buffer protokol dan gRPC melalui HTTP2 untuk berkomunikasi dengan antarmuka RPC. Anda dapat mengetahui apakah API kompatibel dengan gRPC dengan memeriksa bagian API dan Referensinya.
Jika Google Cloud API diaktifkan untuk gRPC, Anda dapat membuat library klien gRPC Anda sendiri untuk API tersebut 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 Anda.
Jika tidak ingin membuat kode gRPC Anda sendiri, Anda tetap dapat memanfaatkan gRPC: semakin banyak Library Klien Cloud untuk API yang mendukung 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 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 lain 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 konsolGoogle Cloud .