Panduan ini menjelaskan semua langkah penyiapan yang diperlukan untuk mulai menggunakan Cloud Billing Budget API.
Sebelum memulai
Anda harus melakukan hal berikut sebelum membaca panduan ini:
- Membaca Ringkasan Cloud Billing Budget API.
- Membaca Prasyarat Cloud Billing Budget API.
Tentang konsol Google Cloud
Konsol Google Cloud (kunjungi dokumentasi, buka konsol) adalah UI web yang digunakan untuk menyediakan, mengonfigurasi, mengelola, dan memantau sistem yang digunakan produk Google Cloud. Anda dapat menggunakan Konsol Google Cloud untuk menyiapkan dan mengelola resource Google Cloud dan Penagihan Cloud.
1. Memilih atau Membuat project
Untuk menggunakan layanan yang disediakan oleh Google Cloud, Anda harus membuat project. Project menyusun semua resource Google Cloud Anda. Project terdiri dari sekumpulan kolaborator, API yang diaktifkan (dan resource lainnya), alat pemantauan, informasi penagihan, serta kontrol akses dan autentikasi. Anda dapat membuat satu atau beberapa project, dan menggunakannya untuk menyusun resource Google Cloud Anda dalam hierarki resource. Untuk mengetahui informasi project lebih lanjut, lihat dokumentasi Resource Manager.
Rekomendasi: Sebaiknya konfigurasikan satu project Google Cloud terpisah untuk menampung semua kebutuhan administrasi penagihan Anda, termasuk Cloud Billing Budget API. Project Google Cloud administrasi penagihan juga dapat digunakan untuk hal-hal seperti akses Cloud Billing Account API, data ekspor Penagihan Cloud, saluran Pub/Sub untuk notifikasi anggaran terprogram, dan seterusnya.
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
2. Mengaktifkan penagihan
Anda harus memastikan bahwa penagihan diaktifkan telah pada project yang Anda gunakan untuk memanggil Cloud Billing Budget API. Jika Anda mengikuti rekomendasi di bagian project, berarti ini adalah project Google Cloud administrasi penagihan Anda.
Akun Penagihan Cloud digunakan untuk menentukan individu yang akan membayar kumpulan resource Google Cloud tertentu. Resource, seperti API yang diaktifkan, diatur dalam project. Akun Penagihan Cloud dapat ditautkan ke satu atau beberapa project. Penggunaan project ditagihkan ke akun penagihan tertaut. Sebagian besar kasus, Anda mengonfigurasi penagihan saat membuat project. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Penagihan.
Anda menyiapkan anggaran Penagihan Cloud untuk memantau Akun Penagihan Cloud. Akun Penagihan Cloud yang Anda pantau bisa berupa Akun Penagihan Cloud yang sama dengan yang ditautkan ke project yang digunakan untuk memanggil Cloud Billing Budget API. Perhatikan bahwa Cloud Billing Budget API gratis digunakan oleh pelanggan Google Cloud. Jika memilih mengonfigurasi notifikasi anggaran terprogram, Anda akan dikenai harga Pub/Sub standar.
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
3. Mengaktifkan API
Anda harus mengaktifkan Cloud Billing Budget API di project yang Anda gunakan untuk memanggil Cloud Billing Budget API. Jika Anda mengikuti rekomendasi di bagian project, berarti ini adalah project Google Cloud administrasi penagihan Anda.
Untuk mengetahui informasi cara mengaktifkan API selengkapnya, lihat dokumentasi Service Usage.
Aktifkan Cloud Billing Budget API.
4. Menyiapkan autentikasi dan otorisasi
Jika berencana menggunakan Cloud Billing Budget API, Anda perlu menyiapkan autentikasi. Setiap aplikasi klien yang menggunakan API harus mengonfirmasi identitasnya dengan cara mengautentikasi. Untuk mengetahui detailnya, lihat Mengautentikasi ke Penagihan Cloud.
Anda mengautentikasi sebagai akun utama tertentu, seperti Akun Google atau akun layanan. Akun utama tersebut harus memiliki peran Identity and Access Management (IAM) yang berisi izin yang diperlukan untuk Cloud Billing Budget API.
Untuk memastikan akun utama memiliki izin yang
diperlukan untuk mengelola anggaran,
minta administrator Anda untuk memberikan peran IAM
Billing Account Administrator pada akun utama (roles/billing.admin
) di akun penagihan Anda.
Untuk mengetahui informasi cara memberikan peran selengkapnya, lihat Mengelola akses.
Administrator Anda mungkin juga dapat memberikan izin yang diperlukan ke akun utama melalui peran khusus atau peran bawaan lainnya.
Untuk mempelajari cara memberikan peran pada akun penagihan, lihat Memperbarui izin Penagihan Cloud.
5. Menginstal dan melakukan inisialisasi gcloud CLI.
Jika berencana menggunakan Cloud Billing Budget API, Anda harus menginstal dan melakukan inisialisasi Google Cloud CLI. Google Cloud CLI adalah serangkaian alat yang dapat Anda gunakan untuk mengelola resource dan aplikasi yang dihosting di Google Cloud. Alat ini mencakup gcloud CLI. Link berikut berisi petunjuk:
Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:
gcloud init
6. Menguji SDK dan autentikasi
Jika di langkah sebelumnya Anda telah menyiapkan autentikasi, Anda dapat menggunakan gcloud CLI untuk menguji lingkungan autentikasi Anda. Jalankan perintah berikut untuk memverifikasi bahwa tidak terjadi error dan kredensial dapat ditampilkan:
gcloud auth print-access-token
Perintah tersebut digunakan oleh semua sampel REST command line Cloud Billing Budget API untuk mengautentikasi panggilan API.
7. Menginstal library klien Cloud Billing Budget API
Cloud Billing Budget API dibuat di HTTP dan JSON sehingga semua klien HTTP standar dapat mengirim permintaan ke Cloud Billing Budget API dan mengurai responsnya.
Anda memiliki tiga opsi untuk memanggil API:
Library klien yang didukung Google (direkomendasikan)
Library klien menyediakan integrasi bahasa yang lebih baik, keamanan yang ditingkatkan, dan dukungan untuk melakukan panggilan yang memerlukan otorisasi pengguna. Library klien yang didukung Google tersedia untuk beberapa bahasa populer, dan bahasa-bahasa ini adalah opsi yang direkomendasikan.