Prasyarat

Sebelum dapat memulai coding aplikasi klien pertama Anda, ada beberapa hal yang perlu dilakukan, jika Anda belum melakukannya.

Membuat Akun Google

Anda memerlukan Akun Google agar dapat diberi akses ke Compute Engine di Konsol API Google. Jika sudah memiliki akun, Anda sudah siap.

Sebaiknya buat Akun Google terpisah untuk tujuan pengujian.

Mendaftar dan mencoba Compute Engine

Untuk memulai, Anda dapat membuat instance VM di Compute Engine menggunakan salah satu panduan berikut:

Penting bagi Anda untuk memahami dasar-dasar Compute Engine sebelum melanjutkan. Dokumentasi API ini berasumsi bahwa Anda telah menggunakan Compute Engine dan memahami konsep pemrograman web dan format data web.

Mempelajari autentikasi

Ada berbagai cara untuk mengautentikasi ke Compute Engine, tergantung pada cara Anda mengakses API. Untuk informasi selengkapnya, lihat Mengautentikasi ke Compute Engine.

Mempelajari REST

Ada dua cara untuk memanggil API:

  • Mengirim permintaan HTTP dan mengurai respons.
  • Menggunakan library klien.

Jika memutuskan untuk tidak menggunakan library klien, Anda harus memahami dasar-dasar REST.

REST adalah gaya arsitektur software yang memberikan pendekatan yang praktis dan konsisten untuk meminta dan memodifikasi data.

Istilah REST adalah singkatan dari "Representational State Transfer". Dalam konteks Google API, REST merujuk pada penggunaan kata kerja HTTP untuk mengambil dan memodifikasi representasi data yang disimpan oleh Google.

Dalam sistem RESTful, resource disimpan di penyimpanan data; klien mengirim permintaan agar server melakukan tindakan tertentu (seperti membuat, mengambil, memperbarui, atau menghapus resource), dan server melakukan tindakan dan mengirim respons, sering kali dalam bentuk representasi resource yang ditentukan.

Di RESTful API Google, klien menentukan tindakan menggunakan kata kerja HTTP seperti POST, GET, PUT, atau DELETE. Kata kerja ini menentukan resource berdasarkan URI yang unik secara global untuk form berikut:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

Karena semua resource API memiliki URI unik yang dapat diakses HTTP, REST memungkinkan caching data dan dioptimalkan untuk berfungsi dengan infrastruktur terdistribusi web.

Anda dapat memperoleh manfaat dari definisi metode dalam dokumentasi standar HTTP 1.1; dokumentasi tersebut menyertakan spesifikasi untuk GET, POST, PUT, dan DELETE.

REST di Compute Engine API

Operasi Compute Engine API dipetakan langsung ke kata kerja REST HTTP.

Format spesifik untuk URI Compute Engine API adalah:

https://www.googleapis.com/compute/v1/resourcePath?parameters

Kumpulan lengkap URI yang digunakan untuk setiap operasi yang didukung di API diringkas dalam dokumen Referensi Compute Engine API.

Mempelajari format data JSON

Compute Engine API menampilkan data dalam format JSON.

JSON (JavaScript Object Notation) adalah format data umum independen bahasa yang memberikan representasi teks sederhana untuk struktur data arbitrer. Untuk informasi selengkapnya, lihat json.org.