Method: files.asyncBatchAnnotate

Menjalankan anotasi dan deteksi gambar asinkron untuk daftar file umum, seperti file PDF, yang dapat berisi beberapa halaman dan beberapa gambar per halaman. Progres dan hasil dapat diambil melalui antarmuka google.longrunning.Operations. Operation.metadata berisi OperationMetadata (metadata). Operation.response berisi AsyncBatchAnnotateFilesResponse (hasil).

Permintaan HTTP

POST https://vision.googleapis.com/v1p3beta1/files:asyncBatchAnnotate

URL menggunakan sintaks gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "requests": [
    {
      object(AsyncAnnotateFileRequest)
    }
  ]
}
Kolom
requests[]

object(AsyncAnnotateFileRequest)

Permintaan anotasi file asinkron individual untuk batch ini.

Isi respons

Jika berhasil, isi respons akan berisi instance Operation.

Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.

AsyncAnnotateFileRequest

Permintaan anotasi file offline.

Representasi JSON 
{
  "inputConfig": {
    object(InputConfig)
  },
  "features": [
    {
      object(Feature)
    }
  ],
  "imageContext": {
    object(ImageContext)
  },
  "outputConfig": {
    object(OutputConfig)
  }
}
Kolom
inputConfig

object(InputConfig)

Wajib. Informasi tentang file input.

features[]

object(Feature)

Wajib. Fitur yang diminta.

imageContext

object(ImageContext)

Konteks tambahan yang mungkin menyertai gambar dalam file.

outputConfig

object(OutputConfig)

Wajib. Lokasi output dan metadata yang diinginkan (misalnya, format).

InputConfig

Lokasi input dan metadata yang diinginkan.

Representasi JSON 
{
  "gcsSource": {
    object(GcsSource)
  },
  "mimeType": string
}
Kolom
gcsSource

object(GcsSource)

Lokasi Google Cloud Storage untuk membaca input.

mimeType

string

Jenis file. Saat ini hanya "application/pdf" dan "image/tiff" yang didukung. Karakter pengganti tidak didukung.

GcsSource

Lokasi Google Cloud Storage tempat input akan dibaca.

Representasi JSON 
{
  "uri": string
}
Kolom
uri

string

URI Google Cloud Storage untuk file input. Hanya boleh berupa objek Google Cloud Storage. Karakter pengganti saat ini tidak didukung.

OutputConfig

Lokasi output dan metadata yang diinginkan.

Representasi JSON 
{
  "gcsDestination": {
    object(GcsDestination)
  },
  "batchSize": number
}
Kolom
gcsDestination

object(GcsDestination)

Lokasi Google Cloud Storage yang menjadi tujuan penulisan output.

batchSize

number

Jumlah maksimum proto respons untuk dimasukkan ke setiap file JSON output di Google Cloud Storage. Rentang yang valid adalah [1, 100]. Jika tidak ditentukan, nilai defaultnya adalah 20.

Misalnya, untuk satu file pdf dengan 100 halaman, 100 proto respons akan dibuat. Jika batchSize = 20, 5 file JSON yang masing-masing berisi 20 proto respons akan ditulis dengan awalan gcsDestination.uri.

Saat ini, batchSize hanya berlaku untuk GcsDestination, dengan potensi dukungan di masa mendatang untuk konfigurasi output lainnya.

GcsDestination

Lokasi Google Cloud Storage tempat output akan ditulis.

Representasi JSON 
{
  "uri": string
}
Kolom
uri

string

URI Google Cloud Storage tempat hasil akan disimpan. Hasil akan berformat JSON dan didahului oleh URI input yang sesuai. Kolom ini dapat mewakili satu file, atau awalan untuk beberapa output. Awalan harus diakhiri dengan /.

Contoh:

Jika ada beberapa output, setiap respons tetap berupa AnnotateFileResponse, yang masing-masing berisi beberapa subset daftar lengkap AnnotateImageResponse. Beberapa output dapat terjadi jika, misalnya, JSON output terlalu besar dan meluber ke beberapa file sharding.