Panduan memulai: Menyiapkan Natural Language API

Panduan ini menyediakan semua langkah penyiapan yang diperlukan untuk mulai menggunakan Natural Language.

Tentang konsol Google Cloud

KonsolGoogle Cloud , adalah UI web yang digunakan untuk menyediakan, mengonfigurasi, mengelola, dan memantau sistem yang menggunakan produk Google Cloud . Anda dapat menggunakan konsol Google Cloud untuk menyiapkan dan mengelola resource Natural Language.

Membuat project

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

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

  • sekumpulan kolaborator
  • API yang diaktifkan (dan resource lainnya)
  • alat pemantauan
  • informasi penagihan
  • kontrol akses dan autentikasi

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

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

  • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
  • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Aktifkan penagihan

Akun penagihan digunakan untuk menentukan siapa yang membayar serangkaian resource tertentu, dan 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.

Verify that billing is enabled for your Google Cloud project.

Mengaktifkan API

Anda harus mengaktifkan Cloud Natural Language API untuk project Anda. Untuk informasi selengkapnya tentang mengaktifkan API, lihat dokumentasi Service Usage.

Enable the Cloud Natural Language API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Menginstal dan melakukan inisialisasi gcloud CLI.

Jika berencana menggunakan Natural Language API, Anda harus menginstal dan melakukan inisialisasi gcloud CLI. gcloud CLI adalah serangkaian alat yang dapat Anda gunakan untuk mengelola resource dan aplikasi yang dihosting di Google Cloud. Ini mencakup gcloud CLI. Link berikut berisi petunjuk:

Instal Google Cloud CLI. Setelah penginstalan, inisialisasi Google Cloud CLI dengan menjalankan perintah berikut: 

gcloud init

Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

Menyiapkan autentikasi

Setiap aplikasi klien yang menggunakan API harus diautentikasi dan diberi akses ke resource yang diminta. Cara Anda menyiapkan autentikasi bergantung pada apakah Anda bekerja di lingkungan pengembangan lokal atau menyiapkan lingkungan produksi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan Kredensial Default Aplikasi.

Select the tabs for how you plan to access the API:

gcloud

Instal Google Cloud CLI. Setelah penginstalan, inisialisasi Google Cloud CLI dengan menjalankan perintah berikut: 

gcloud init

Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

Library klien

Untuk menggunakan library klien di lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.

    Instal Google Cloud CLI.

    Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

    If you're using a local shell, then create local authentication credentials for your user account: 

    gcloud auth application-default login

    You don't need to do this if you're using Cloud Shell.

    If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

Untuk mengetahui informasi selengkapnya, lihat Menyiapkan ADC untuk lingkungan pengembangan lokal dalam dokumentasi autentikasi Google Cloud .

REST

Untuk memakai REST API di lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

    Instal Google Cloud CLI.

    Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .

Untuk mengetahui informasi tentang cara menyiapkan autentikasi bagi lingkungan produksi, lihat Set up Application Default Credentials for code running on Google Cloud di dokumentasi autentikasi Google Cloud .

Menginstal library klien Natural Language API

Anda memiliki tiga opsi untuk memanggil Natural Language API:

Library klien tersedia untuk beberapa bahasa populer. Untuk mengetahui informasi tentang cara menginstal library klien, lihat Library Klien Cloud Natural Language.

Peran IAM

Untuk mendapatkan izin yang diperlukan guna mengakses Cloud Natural Language API, minta administrator Anda untuk memberi Anda peran IAM Service Usage Consumer (roles/serviceusage.serviceUsageConsumer) di project kuota Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.