Memulai

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 di aplikasi, Anda harus memiliki Akun Google terlebih dahulu. Dengan begitu, Anda dapat menggunakan produk developer Google, termasuk Google Cloud Console, 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. Library ini berfungsi sebagai container resource untuk resource Google Cloud Anda. Hal ini juga memberikan batas isolasi untuk penggunaan layanan Google Cloud, sehingga Anda dapat mengelola batas kuota dan penagihan secara independen di level project. Telemetri penggunaan dan dasbor juga dikelompokkan berdasarkan project. Jika belum memiliki project, Anda dapat membuatnya menggunakan Konsol Google Cloud.

Sebuah 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 Google Cloud Console untuk menghapus project. Project Anda dan semua resource dalam project akan dihapus setelah periode retensi. Perlu diperhatikan bahwa jenis data yang berbeda memiliki periode retensi data yang berbeda pula.

Menemukan API

Sebelum menggunakan Cloud API, Anda harus menggunakan Library API Google Cloud Console untuk menjelajahi Cloud API yang tersedia dan menemukan yang paling sesuai dengan kebutuhan bisnis Anda. Untuk informasi selengkapnya tentang Cloud API tertentu, buka 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. Jika Anda mengaktifkan API yang bergantung pada API lain, API tersebut juga akan diaktifkan pada saat yang sama.

Untuk mengaktifkan API, Anda harus menyetujui Persyaratan Layanan dan tanggung jawab penagihan untuk API. Anda memerlukan izin serviceusage.services.enable pada project untuk mengaktifkan API. Untuk mengetahui informasi selengkapnya, lihat Kontrol Akses Penggunaan Layanan.

Selain itu, layanan yang akan diaktifkan harus bersifat publik. Jika tidak, pemilik layanan harus memberikan izin servicemanagement.services.bind kepada pengguna pada layanan pribadi. Lihat Kontrol Akses Pengelolaan Layanan untuk mengetahui informasi selengkapnya.

Untuk mengaktifkan API bagi project menggunakan konsol:

  1. Buka Library API Google Cloud Console.
  2. Dari daftar project, pilih project yang ingin digunakan.
  3. Di Library API, pilih API yang ingin Anda aktifkan. Jika Anda memerlukan bantuan untuk menemukan API, gunakan kolom penelusuran dan/atau filter.
  4. Di halaman API, klik AKTIFKAN.

Dari halaman yang sama, Anda dapat menonaktifkan API untuk project jika tidak lagi menggunakannya untuk menghindari penyalahgunaan dan biaya 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 atas penggunaan. Anda harus mengaktifkan penagihan untuk project sebelum dapat mulai menggunakan API ini di project. Penggunaan API dalam sebuah project ditagihkan ke akun penagihan yang terkait dengan project tersebut.

Jika Anda tidak memiliki akun penagihan, buka halaman penagihan Konsol Google Cloud dan ikuti petunjuk untuk membuatnya. Kemudian, tautkan akun penagihan Anda ke project Anda.

Mengautentikasi ke API

Cara Anda melakukan autentikasi ke API bergantung pada lingkungan pengembangan Anda dan metode autentikasi yang didukung API tersebut.

Menyiapkan Kredensial Default Aplikasi untuk digunakan di berbagai lingkungan adalah pendekatan yang paling umum, dan direkomendasikan untuk sebagian besar aplikasi. Opsi lain tersedia jika API mendukung kunci API. Jika aplikasi Anda perlu mengakses resource Cloud yang dimiliki oleh pengguna akhir Anda, buat Client ID OAuth 2.0 dan gunakan library autentikasi.

Untuk mengetahui informasi umum tentang autentikasi, lihat Autentikasi di Google.

Membangun aplikasi

Jika Anda membangun aplikasi menggunakan Cloud API, sebaiknya gunakan Library Klien Google Cloud jika tersedia. Library klien dapat menangani fitur API umum demi kemudahan 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:

Untuk informasi selengkapnya, lihat Penjelasan Library Klien.

Informasi selengkapnya