Pesan error

Pelajari cara mengatasi beberapa error yang dilaporkan oleh Document AI. Topik ini membahas error yang penyelesaiannya memerlukan lebih banyak langkah daripada yang dapat dijelaskan dalam pesan error.

Lihat dokumentasi Cloud API untuk mengetahui praktik penanganan error yang direkomendasikan.

Izin

Penyelesaiannya memerlukan beberapa langkah yang harus dilakukan seperti yang diuraikan dalam pesan error.

Kredensial default aplikasi tidak tersedia

Jika Anda menerima pesan ini:

The Application Default Credentials are not available. They are
available if running in Compute Engine. Otherwise, the
environment variable GOOGLE_APPLICATION_CREDENTIALS must be defined
pointing to a file defining the credentials.
See https://developers.google.com/accounts/docs/application-default-credentials
for more information.

Document AI menggunakan Kredensial Default Aplikasi untuk autentikasi.

Anda harus memiliki akun layanan untuk project Anda, download kunci (file JSON) untuk akun layanan ke lingkungan pengembangan Anda, lalu tetapkan lokasi file JSON tersebut ke variabel lingkungan bernamaGOOGLE_APPLICATION_CREDENTIALS.

Selain itu, variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS harus tersedia dalam konteks di mana Anda memanggil Document AI API. Misalnya, jika Anda menetapkan variabel dari dalam sesi terminal, tetapi menjalankan kode di debugger IDE, konteks eksekusi kode Anda mungkin tidak memiliki akses ke variabel tersebut. Dalam situasi tersebut, permintaan Anda ke Document AI mungkin gagal karena tidak memiliki autentikasi yang tepat.

Untuk mengetahui informasi selengkapnya tentang cara menetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS, lihat panduan memulai Document AI atau dokumentasi tentang menggunakan Kredensial Default Aplikasi.

Izin ditolak

Jika Anda menerima pesan ini:

ERROR: (gcloud.auth.application-default.print-access-token) File
(pointed by GOOGLE_APPLICATION_CREDENTIALS environment variable) does not exist!
{
  "error": {
    "code": 403,
    "message": "The request is missing a valid API key.",
    "status": "PERMISSION_DENIED"
  }
}

Pastikan Anda memiliki file JSON kunci akun layanan yang valid di lokasi yang disimpan dalam variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS dan bahwa variabel tersebut menunjuk ke tempat yang benar.

Untuk mendiagnosis error ini, coba buka file kunci akun layanan dari folder tempat Anda mencoba memanggil Document AI API.

cat $GOOGLE_APPLICATION_CREDENTIALS

Forbidden: 403 POST API belum digunakan atau dinonaktifkan

Jika Anda menerima pesan ini:

Forbidden: 403 POST Document AI API has not been used in
project # before or it is disabled.
Enable it by visiting [url], then retry.
If you enabled this API recently, wait a few minutes for the action to
propagate and retry.

1. Buka link yang ditentukan dalam pesan error dan aktifkan Document AI API. Tunggu beberapa menit, lalu coba lagi.
2. Pastikan Anda memiliki file JSON kunci akun layanan valid yang tersimpan di variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS. Untuk mendiagnosis error ini, coba buka file kunci akun layanan dari folder tempat Anda mencoba memanggil Document AI API.

   cat $GOOGLE_APPLICATION_CREDENTIALS
   

Terjadi error saat menulis output akhir

Jika Anda menerima pesan seperti berikut saat menerima hasil permintaan batch processing:

{
  "name": "projects/project-name/operations/operation-id",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.document.v1beta1.OperationMetadata",
    "state": "SUCCEEDED",
    "createTime": "2019-09-19T02:02:15.885267760Z",
    "updateTime": "2019-09-19T02:02:31.896425001Z"
  },
  "done": true,
  "error": {
    "code": 5,
    "message": "Error writing final output to: gs://bucket-name/filename.json"
  }
}

Akun layanan Anda mungkin tidak memiliki izin yang benar untuk membuat objek di bucket Cloud Storage Anda. Pastikan Anda telah menetapkan izin yang benar ke akun layanan Anda, seperti yang dijelaskan dalam panduan memulai cepat.

Anda mungkin juga salah mengeja nama bucket Cloud Storage. Pastikan bucket yang ingin Anda akses ada.

P4SA tidak memiliki akses ke Cloud Storage

Jika Akun Layanan Per-Produk (P4SA) Document AI tidak memiliki izin untuk mengakses beberapa resource Cloud Storage.

message: "Cloud DocumentAI P4SA doesn't have access to this Cloud Storage resource:"

Akun Layanan tidak dapat membuat objek di Cloud Storage

Saat Akun Layanan Per-Produk (P4SA) Document AI tidak memiliki izin untuk membuat objek di Cloud Storage.

message: "Service account service-123@gcp-sa-prod-dai-core.iam.gserviceaccount.com
         does not have permission storage.objects.create to create
         Google Cloud Storage object in bucket gs://foo."

Akun layanan Document AI mungkin tidak memiliki izin yang benar untuk membuat objek di bucket Cloud Storage Anda. Pastikan Anda telah menetapkan izin yang benar ke akun layanan Document AI, seperti yang dijelaskan dalam penyiapan akses file lintas project.

Anda mungkin juga salah mengeja nama bucket Cloud Storage. Pastikan bucket yang ingin Anda akses ada.

Pemanggil tidak dapat mengambil objek di Cloud Storage

Saat pemanggil Document AI API tidak memiliki izin untuk mendapatkan objek di Cloud Storage.

message: "The caller does not have permission storage.objects.get to get Google
         Cloud Storage objects in bucket gs://foo."