Memulai

Dengan menyiapkan project Cloud de Confiance by S3NS dan mengonfigurasi autentikasi, Anda dapat memanggil API Cloud de Confiance dari aplikasi. Dalam dokumen ini, Anda akan mulai menggunakan API Cloud de Confiance dengan membuat project, menemukan dan mengaktifkan layanan di Library API, menautkan akun penagihan, menyiapkan kredensial, dan menjelajahi library klien.

Membuat project Cloud de Confiance

Untuk menggunakan Cloud de Confiance API, Anda harus memiliki akun pengguna (akun S3NS atau akun dari penyedia identitas eksternal) dan projectCloud de Confiance . Project setara dengan akun developer. Project ini berfungsi sebagai container resource untuk resource Cloud de Confiance Anda. Project juga menyediakan batas isolasi untuk penggunaan layanan Cloud de Confiance by S3NS , sehingga Anda dapat mengelola batas kuota dan penagihan secara independen di level project. Telemetri dan dasbor penggunaan juga dikelompokkan berdasarkan project. Jika belum memiliki project, Anda dapat membuatnya menggunakan Cloud de Confiance 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 API Cloud de Confiance , project yang memiliki kredensial aplikasi disebut project klien, dan project yang memiliki resource target disebut project resource. Beberapa permintaan API dapat menyentuh beberapa resource, sehingga lebih dari satu project resource dapat terlibat dalam permintaan tersebut.

Jika Anda ingin berhenti menggunakan Cloud de Confiance karena alasan apa pun, Anda dapat menggunakan konsolCloud de Confiance untuk menghapus project Anda. 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 API Cloud de Confiance , Anda harus menggunakanLibrary APIkonsol Cloud de Confiance untuk menjelajahi APICloud de Confiance yang tersedia dan menemukan API yang paling sesuai dengan kebutuhan bisnis Anda.

Mengaktifkan API

Beberapa API Cloud de Confiance diaktifkan secara default. Untuk menggunakan Cloud de Confiance API yang tidak diaktifkan secara default, Anda harus mengaktifkannya untuk project Anda. Bergantung pada layanan dan project mana 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 tersebut. Anda memerlukan izin serviceusage.services.enable pada project untuk mengaktifkan API.

Untuk mengaktifkan API untuk project menggunakan konsol:

  1. Buka Library API konsolCloud de Confiance .
  2. Dari daftar project, pilih project yang ingin Anda gunakan.
  3. Di Library API, pilih API yang ingin Anda aktifkan. Jika Anda memerlukan bantuan untuk menemukan API, gunakan kolom penelusuran dan filter.
  4. Di halaman API, klik ENABLE.

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

Melakukan Autentikasi ke API

Cara Anda melakukan autentikasi ke API bergantung pada lingkungan pengembangan Anda 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.

Membangun aplikasi

Jika Anda membangun aplikasi menggunakan Cloud API, sebaiknya gunakan library klienCloud de Confiance 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 keCloud de Confiance API atas nama aplikasi Anda.

Informasi selengkapnya