Halaman ini diterjemahkan oleh Cloud Translation API.

Panduan memulai: Menyiapkan Document AI API

Panduan ini menyediakan semua langkah penyiapan yang diperlukan untuk mulai menggunakan Document AI.

Tentang konsol Google Cloud

Konsol Google 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 Document AI.

Membuat project

Untuk menggunakan layanan yang disediakan oleh Google Cloud, Anda harus membuat project, yang mengatur semua resource Google Cloud dan terdiri dari komponen berikut:

Sekumpulan kolaborator
API yang diaktifkan (dan resource lainnya)
Alat pemantauan
Informasi penagihan
Autentikasi dan kontrol akses
Prosesor Document AI

Anda dapat membuat satu project, atau beberapa project. Anda dapat menggunakan project untuk mengatur 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.

Go to project selector

Mengaktifkan API

Anda harus mengaktifkan Document AI API untuk project Anda. Untuk informasi selengkapnya tentang mengaktifkan API, lihat dokumentasi Service Usage.

Enable the Document AI API.

Enable the API

Aktifkan penagihan

Akun penagihan menentukan siapa yang membayar sekumpulan resource tertentu. Akun penagihan dapat ditautkan ke satu atau beberapa project. Penggunaan project ditagihkan ke akun penagihan tertaut. Anda mengonfigurasi penagihan saat membuat project. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Penagihan.

Make sure that billing is enabled for your Google Cloud project.

Lokasi

Document AI menawarkan beberapa kontrol terkait lokasi penyimpanan dan pemrosesan resource untuk project Anda. Secara khusus, saat membuat pemroses, Anda harus memilih lokasi untuk menyimpan dan memproses data. Secara default, Document AI menyimpan dan memproses resource di lokasi Amerika Serikat. Jika Anda memilih lokasi Uni Eropa, data dan proses Anda hanya disimpan di Uni Eropa.

Menetapkan lokasi menggunakan API

Anda harus menentukan lokasi pemroses setiap kali mengirim permintaan pemrosesan menggunakan API. Misalnya, jika pemroses Anda dikonfigurasi untuk menyimpan dan memproses data Anda di Uni Eropa, gunakan URI eu-documentai.googleapis.com sebagai berikut:

`Process`	`https://eu-documentai.googleapis.com/v1/projects/$PROJECT_ID/locations/eu/processors/$PROCESSOR_ID:process` `https://eu-documentai.googleapis.com/v1beta3/projects/$PROJECT_ID/locations/eu/processors/$PROCESSOR_ID:process`
`batchProcess`	`https://eu-documentai.googleapis.com/v1/projects/$PROJECT_ID/locations/eu/processors/$PROCESSOR_ID:batchProcess` `https://eu-documentai.googleapis.com/v1beta3/projects/$PROJECT_ID/locations/eu/processors/$PROCESSOR_ID:batchProcess`

Menginstal library klien Document AI API

Anda memiliki tiga opsi untuk memanggil Document AI API:

Library klien yang didukung Google (direkomendasikan)
REST
gRPC

Library klien tersedia untuk beberapa bahasa populer. Untuk mengetahui informasi tentang cara menginstal library klien, lihat library klien Document AI API.

Instal dan lakukan inisialisasi pada Google Cloud CLI

gcloud CLI menyediakan serangkaian alat yang dapat Anda gunakan untuk mengelola resource dan aplikasi yang dihosting di Google Cloud.

Link berikut berisi petunjuk:

Install the Google Cloud CLI, then initialize it by running the following command:

gcloud init

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 informasi selengkapnya, lihat Menyiapkan Kredensial Default Aplikasi.

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

gcloud

Install the Google Cloud CLI, then initialize it by running the following command:

gcloud init

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.

Install the Google Cloud CLI.
To initialize the gcloud CLI, run the following command:
```
gcloud init
```
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.

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

REST

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

Install the Google Cloud CLI, then initialize it by running the following command:

gcloud init

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

Untuk 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 .

Tentang peran

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

Untuk mencoba Document AI API, Anda dapat menggunakan peran Project > Pemilik dalam langkah-langkah di bawah. Peran Project > Owner memberikan izin penuh ke akun layanan untuk resource di project Anda. Jika permintaan Anda tidak memerlukan izin penuh, Anda dapat menentukan peran yang lebih ketat menggunakan konsol Google Cloud. Untuk mengetahui daftar izin dan peran untuk Document AI, lihat izin Document AI dan peran Document AI. Untuk mengetahui informasi tentang cara mengelola izin menggunakan peran IAM, lihat Mengelola akses ke project, folder, dan organisasi.

Penyiapan akses file lintas project

Saat menyiapkan pemroses Document AI di satu project, Anda mungkin ingin project ini mengakses file input yang disimpan di project lain dalam organisasi yang sama yang menghosting pemroses Document AI.

Untuk mengizinkan akses lintas project, Anda harus memberikan peran Storage Object Viewer (roles/storage.objectViewer) ke akun layanan Document AI default, seperti yang ditunjukkan pada gambar berikut.

setup-1

Contoh

Misalkan project A menghosting pemroses Document AI, dan secara opsional menghosting bucket tempat output pemroses ditulis.
Project B memiliki bucket yang berisi file input untuk pemroses Document AI.
Agar file di project B dapat diakses oleh project A, Anda harus memberikan peran Storage Object Viewer (roles/storage.objectViewer) untuk bucket input di project B ke akun layanan Document AI dari project A.

Untuk mengetahui informasi selengkapnya tentang IAM dan Storage Object Viewer, lihat Peran IAM untuk Cloud Storage.

Akun layanan bawaan

Akun layanan Document AI mengikuti konvensi penamaan ini:

service-{project number}@gcp-sa-prod-dai-core.iam.gserviceaccount.com

Contoh: service-361747088407@gcp-sa-prod-dai-core.iam.gserviceaccount.com

setup-3

Langkah Berikutnya: Kasus penggunaan

Setelah Document AI API diaktifkan, pemroses Document AI dapat dibuat dan digunakan. Jenis prosesor mana yang paling tepat bergantung pada kasus penggunaan Anda.

Berikutnya

Pengayaan