Menyiapkan API Enterprise Knowledge Graph

Panduan ini menyediakan semua langkah penyiapan yang diperlukan untuk mulai menggunakan Enterprise Knowledge Graph.

Tentang the Google Cloud konsol

Konsol Google Cloud console adalah UI web yang digunakan untuk menyediakan, mengonfigurasi, mengelola, dan memantau sistem yang menggunakan Google Cloud produk. Anda dapat menggunakan Google Cloud konsol untuk menyiapkan dan mengelola resource Enterprise Knowledge Graph.

Membuat project

Untuk menggunakan layanan yang disediakan oleh Google Cloud, Anda harus membuat project.

Sebuah project akan mengorganisasikan semua resource Anda Google Cloud . Project terdiri dari komponen berikut:

  • Kumpulan kolaborator
  • API yang diaktifkan (dan resource lainnya)
  • Alat pemantauan
  • Informasi penagihan
  • Kontrol akses dan autentikasi

Anda dapat membuat satu project, atau membuat beberapa project. Anda dapat menggunakan project untuk mengorganisasikan Google Cloud resource dalam hierarki resource. Untuk mengetahui informasi project lebih lanjut, lihat dokumentasi Resource Manager.

Di Google Cloud konsol, pada halaman pemilih project, pilih atau buat Google Cloud project.

Peran yang diperlukan untuk memilih atau membuat project

  • Memilih project: Memilih project tidak memerlukan peran IAM tertentu Anda dapat memilih project mana pun yang telah diberi peran.
  • Membuat project: Untuk membuat project, Anda memerlukan peran Project Creator (roles/resourcemanager.projectCreator), yang berisi izin resourcemanager.projects.create. Pelajari cara memberikan peran.

Buka pemilih project

Mengaktifkan API

Anda harus mengaktifkan Enterprise Knowledge Graph API untuk project Anda. Untuk mengetahui informasi selengkapnya tentang cara mengaktifkan API, lihat dokumentasi Penggunaan Layanan.

Aktifkan Enterprise Knowledge Graph API.

Peran yang diperlukan untuk mengaktifkan API

Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Admin Penggunaan Layanan (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.

Mengaktifkan API

Menyiapkan autentikasi

Setiap aplikasi klien menggunakan API harus diautentikasi dan diberi akses ke resource yang diminta. Bagian ini menjelaskan konsep autentikasi penting dan memberikan langkah-langkah untuk menyiapkannya. Untuk mengetahui informasi selengkapnya, lihat Ringkasan autentikasi.

Tentang akun layanan

Ada beberapa opsi untuk autentikasi, tetapi sebaiknya gunakan akun layanan untuk autentikasi dan kontrol akses. Akun layanan memberikan kredensial untuk aplikasi, bukan untuk pengguna akhir. Project memiliki akun layanannya sendiri. Anda dapat membuat banyak akun layanan untuk sebuah project. Untuk mengetahui informasi selengkapnya, lihat Akun layanan.

Tentang peran

Saat memanggil API, Google Cloud memerlukan identitas (orang, entity, atau proses yang berlaku dan atribut yang ditentukan) panggilan untuk memiliki izin yang sesuai. Anda dapat memberikan izin dengan memberikan peran ke akun layanan. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Identity and Access Management (IAM).

Untuk mencoba Enterprise Knowledge Graph API, Anda dapat menggunakan peran Project > Owner dalam langkah-langkah berikut. Peran Project > Owner memberikan izin penuh ke akun layanan untuk mengakses resource di project Anda. Jika akun layanan Anda tidak memerlukan izin penuh, Anda dapat menentukan peran yang lebih ketat menggunakan Google Cloud konsol. Untuk mengetahui daftar izin dan peran untuk Enterprise Knowledge Graph, lihat Izin Enterprise Knowledge Graph dan Peran Enterprise Knowledge Graph. Untuk mengetahui informasi tentang cara mengelola izin menggunakan peran IAM, lihat memberikan peran ke akun layanan.

Tentang kunci akun layanan

Akun layanan dikaitkan dengan satu atau beberapa pasangan kunci publik atau pribadi. Saat membuat pasangan kunci baru, Anda akan mendownload kunci pribadi. Google Cloud CLI menggunakan kunci pribadi Anda untuk membuat kredensial saat memanggil API.

Membuat akun layanan dan mendownload file kunci pribadi

Membuat akun layanan:

  1. Pastikan Anda memiliki peran IAM Buat Akun Layanan (roles/iam.serviceAccountCreator) dan peran Admin IAM Project (roles/resourcemanager.projectIamAdmin). Pelajari cara memberikan peran.

  2. Di Google Cloud konsol, buka halaman Buat akun layanan.

    Buka Buat akun layanan
  3. Pilih project Anda.

  4. Di kolom Nama akun layanan, masukkan nama. Konsol akan mengisi kolom ID akun layanan berdasarkan nama ini. Google Cloud

    Di kolom Deskripsi akun layanan, masukkan sebuah deskripsi. Sebagai contoh, Service account for quickstart.

  5. Klik Create and continue.

  6. Berikan peran Project > Owner ke akun layanan.

    Untuk memberikan peran, temukan daftar Select a role, lalu pilih Project > Owner.

  7. Klik Lanjutkan.

  8. Klik Selesai untuk menyelesaikan pembuatan akun layanan.

    Jangan tutup jendela browser Anda. Anda akan menggunakannya pada langkah berikutnya.

Membuat kunci akun layanan:

  1. Di Google Cloud konsol, klik alamat email untuk akun layanan yang telah dibuat.
  2. Klik Keys.
  3. Klik Tambahkan kunci, lalu klik Buat kunci baru.
  4. Klik Create. File kunci JSON akan didownload ke komputer Anda.
  5. Klik Close.

Menggunakan file kunci akun layanan di lingkungan Anda