Halaman ini menjelaskan cara developer dapat mulai menggunakan Google Cloud API.
Jika menggunakan Google Cloud API untuk pertama kalinya, Anda dapat mengikuti langkah-langkah dalam panduan ini untuk memanggil API menggunakan perintah curl
. Anda dapat menggunakan
perintah curl
untuk bereksperimen dengan API sebelum mengembangkan aplikasi.
Membuat Akun Google
Untuk menggunakan Google Cloud API dalam aplikasi, Anda harus memiliki akun Google terlebih dahulu. Dengan demikian, Anda dapat menggunakan produk developer Google, termasuk konsol Google Cloud, gcloud CLI, Cloud Logging, dan Cloud Monitoring. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
Membuat project Google
Untuk menggunakan Cloud API, Anda juga harus memiliki project Google. Project setara dengan akun developer. Project ini berfungsi sebagai penampung resource untuk resource Google Cloud Anda. Project juga menyediakan batas isolasi untuk penggunaan layanan Google Cloud, sehingga Anda dapat mengelola batas kuota dan penagihan secara independen di tingkat project. Telemetri dan dasbor penggunaan juga dikelompokkan berdasarkan project. Jika belum memiliki project, Anda dapat membuatnya menggunakan Google Cloud console.
Project dapat memiliki berbagai resource, termasuk kunci API, klien OAuth, akun layanan, VM Compute Engine, bucket Cloud Storage, dan set data BigQuery. Saat aplikasi memanggil Cloud API, project yang memiliki kredensial aplikasi disebut project klien, dan project yang memiliki resource target disebut project resource. Satu permintaan API dapat menyentuh beberapa resource, sehingga beberapa project resource terlibat.
Jika ingin berhenti menggunakan Google Cloud karena alasan apa pun, Anda dapat menggunakan konsol Google Cloud untuk menghapus project. Project Anda dan semua resource dalam project akan dihapus setelah periode retensi. Perhatikan bahwa berbagai jenis data memiliki periode retensi yang berbeda.
Menemukan API
Sebelum menggunakan Cloud API apa pun, Anda harus menggunakan Library API konsol Google Cloud untuk menjelajahi Cloud API yang tersedia dan menemukan API yang paling sesuai dengan kebutuhan bisnis Anda. Untuk informasi selengkapnya tentang Cloud API tertentu, kunjungi situs dokumentasi publiknya, seperti Spanner API.
Mengaktifkan API
Beberapa Cloud API diaktifkan secara default. Untuk menggunakan Cloud API yang tidak diaktifkan secara default, Anda harus mengaktifkannya untuk project Anda. Bergantung pada layanan dan project yang terlibat dari aplikasi Anda, termasuk project klien dan project resource, Anda mungkin perlu mengaktifkan API untuk beberapa project. Saat Anda mengaktifkan API yang bergantung pada API lain, API tersebut juga akan diaktifkan secara bersamaan.
Untuk mengaktifkan API, Anda harus menyetujui Persyaratan Layanan dan tanggung jawab penagihan untuk API. Anda memerlukan izin serviceusage.services.enable
di project untuk mengaktifkan API. Untuk mengetahui informasi selengkapnya, lihat Kontrol Akses
Usage Layanan.
Selain itu, layanan yang akan diaktifkan harus bersifat publik, atau pemilik layanan
harus memberikan izin servicemanagement.services.bind
kepada pengguna di
layanan pribadi. Lihat Kontrol Akses Pengelolaan Layanan untuk mengetahui informasi selengkapnya.
Untuk mengaktifkan API untuk project menggunakan konsol:
- Buka Library API konsol Google Cloud.
- Dari daftar project, pilih project yang ingin Anda gunakan.
- Di Library API, pilih API yang ingin Anda aktifkan. Jika Anda memerlukan bantuan untuk menemukan API, gunakan kolom penelusuran dan/atau filter.
- Di halaman API, klik ENABLE.
Dari halaman yang sama, Anda dapat menonaktifkan API untuk project jika tidak lagi menggunakannya untuk menghindari penyalahgunaan dan tagihan penagihan yang tidak disengaja. Anda juga dapat mengaktifkan dan menonaktifkan Cloud API menggunakan gcloud CLI dan Service Usage API:
$ gcloud services enable pubsub.googleapis.com
$ gcloud services disable pubsub.googleapis.com
Mengaktifkan penagihan
Beberapa Cloud API mengenakan biaya penggunaan. Anda harus mengaktifkan penagihan untuk project sebelum dapat mulai menggunakan API ini dalam project. Penggunaan API dalam project ditagih ke akun penagihan yang terkait dengan project.
Jika Anda belum memiliki akun penagihan, buka halaman penagihan Google Cloud Console dan ikuti petunjuk untuk membuatnya. Kemudian, tautkan akun penagihan ke project Anda.
Mengautentikasi ke API
Cara Anda melakukan autentikasi ke API bergantung pada lingkungan pengembangan dan metode autentikasi yang didukung API.
Menyiapkan Kredensial Default Aplikasi untuk digunakan di berbagai lingkungan adalah pendekatan yang paling umum, dan direkomendasikan untuk sebagian besar aplikasi. Jika API mendukung kunci API, itu adalah opsi lain. Jika aplikasi Anda perlu mengakses resource Cloud yang dimiliki oleh pengguna akhir, Anda harus membuat Client ID OAuth 2.0 dan menggunakan library autentikasi.
Untuk informasi umum tentang autentikasi, lihat Autentikasi di Google.
Mem-build aplikasi
Jika Anda mem-build aplikasi menggunakan Cloud API, sebaiknya gunakan Library Klien Google Cloud jika tersedia. Library klien dapat menangani fitur API umum untuk memudahkan Anda, seperti autentikasi, penanganan error, percobaan ulang, dan validasi payload. Anda harus meneruskan kredensial aplikasi ke library klien selama inisialisasi, sehingga library klien dapat melakukan panggilan ke Google Cloud API atas nama aplikasi Anda.
Lihat panduan langkah demi langkah berikut yang menggunakan library klien untuk beberapa API populer:
- Cloud Billing Budget API dengan Node.js.
- Cloud Billing Budget API dengan Python.
- Cloud Logging dengan Node.js.
- Cloud Logging dengan Python.
- Cloud Logging dengan Go.
- Cloud Logging dengan Java.
- Speech-to-Text dengan Node.js.
- Speech-to-Text dengan Python.
- Speech-to-Text dengan Go.
- Speech-to-Text dengan Java.
Untuk informasi selengkapnya, lihat Penjelasan Library Klien.
Informasi selengkapnya
Untuk informasi selengkapnya tentang autentikasi, lihat Autentikasi di Google.
Untuk informasi selengkapnya tentang penanganan error, lihat Menangani Error.
Untuk mengetahui informasi selengkapnya tentang penagihan, lihat Membuat, mengubah, atau menutup akun penagihan.
Untuk mengetahui informasi selengkapnya tentang cara mengaktifkan penagihan di project Anda, lihat Mengubah setelan penagihan project.
Untuk mengetahui informasi selengkapnya tentang cara mengaktifkan dan menonaktifkan API, lihat Mengaktifkan dan menonaktifkan layanan.