Method: files.annotate

Layanan yang menjalankan deteksi dan anotasi gambar untuk batch file. Sekarang hanya "aplikasi/pdf", "gambar/tiff" dan "gambar/gif" yang didukung.

Layanan ini akan mengekstrak maksimal 5 (pelanggan dapat menentukan 5 dalam AnnotateFileRequest.pages) frame (gif) atau halaman (pdf atau tiff) dari setiap file yang disediakan dan melakukan deteksi serta anotasi untuk setiap gambar yang diekstrak.

Permintaan HTTP

POST https://vision.googleapis.com/v1p4beta1/files:annotate

URL menggunakan sintaks gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

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

object (AnnotateFileRequest)

Daftar permintaan anotasi file. Saat ini kami hanya mendukung satu AnnotateFileRequest di BatchAnnotateFilesRequest.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Daftar respons anotasi file.

Representasi JSON 
{
  "responses": [
    {
      object (AnnotateFileResponse)
    }
  ]
}
Kolom
responses[]

object (AnnotateFileResponse)

Daftar respons anotasi file, setiap respons sesuai dengan setiap AnnotateFileRequest di BatchAnnotateFilesRequest.

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.

AnnotateFileRequest

Permintaan untuk menganotasi satu file, misalnya file PDF, TIFF, atau GIF.

Representasi JSON 
{
  "inputConfig": {
    object (InputConfig)
  },
  "features": [
    {
      object (Feature)
    }
  ],
  "imageContext": {
    object (ImageContext)
  },
  "pages": [
    number
  ]
}
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.

pages[]

number

Halaman file untuk menjalankan anotasi gambar.

Halaman dimulai dari 1, kami berasumsi bahwa halaman pertama file adalah halaman 1. Maksimal 5 halaman didukung per permintaan. Halaman bisa negatif.

Halaman 1 berarti halaman pertama. Halaman 2 berarti halaman kedua. Halaman -1 berarti halaman terakhir. Halaman -2 berarti halaman kedua dari halaman terakhir.

Jika file berupa GIF, bukan PDF atau TIFF, halaman akan merujuk ke frame GIF.

Jika kolom ini kosong, secara default layanan akan melakukan anotasi gambar untuk 5 halaman pertama file.

AnnotateFileResponse

Respons terhadap permintaan anotasi file tunggal. File dapat berisi satu atau beberapa gambar, yang masing-masing memiliki respons tersendiri.

Representasi JSON 
{
  "inputConfig": {
    object (InputConfig)
  },
  "responses": [
    {
      object (AnnotateImageResponse)
    }
  ],
  "totalPages": number
}
Kolom
inputConfig

object (InputConfig)

Informasi tentang file yang menghasilkan respons ini.

responses[]

object (AnnotateImageResponse)

Respons individual terhadap gambar yang ditemukan dalam file.

totalPages

number

Kolom ini menunjukkan jumlah total halaman dalam file,