Method: projects.locations.setDedicatedCrawlRate

Menetapkan kecepatan crawl khusus untuk crawlRateScope. Jika kecepatan crawl khusus tidak ditetapkan, tindakan ini akan memungkinkan bot crawl Vertex AI menggunakan kecepatan crawl khusus yang baru untuk crawling. Jika kecepatan crawl khusus telah ditetapkan, bot crawl Vertex AI akan mencoba memperbarui kecepatan ke nilai baru. Jika nilai baru terlalu tinggi, bot crawl mungkin melakukan crawl dengan kecepatan yang lebih rendah untuk menghindari kelebihan muatan pada situs pengguna.

Permintaan HTTP

POST https://discoveryengine.googleapis.com/v1beta/{location=projects/*/locations/*}:setDedicatedCrawlRate

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
location

string

Wajib. Resource lokasi tempat pengelolaan kecepatan crawl akan dilakukan. Format: projects/{project}/locations/{location}

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "crawlRateScope": string,
  "crawlRate": integer,
  "crawlType": enum (CrawlType),
  "mode": enum (Mode)
}
Kolom
crawlRateScope

string

Wajib. Cakupan kecepatan crawl yang ingin dikonfigurasi pengguna. Saat ini, hanya nama domain dan host yang didukung. Contoh nama domain: example.com. Contoh nama host: www.example.com. Jangan sertakan / dalam nama domain atau host.
crawlRate

integer

Opsional. QPS crawl yang ditetapkan oleh pengguna. Tidak ada jaminan bahwa bot crawl Vertex akan melakukan crawl pada QPS ini. Jika kecepatan crawl terlalu tinggi, QPS sebenarnya mungkin lebih rendah daripada nilai yang ditetapkan oleh pengguna untuk menghindari kelebihan beban pada situs pengguna.
crawlType

enum (CrawlType)

Opsional. Apakah itu kecepatan crawl yang dipicu pengguna atau refresh otomatis.
mode

enum (Mode)

Opsional. Apakah tarif ditetapkan secara eksplisit oleh pengguna, atau ditetapkan oleh Vertex AI.

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/discoveryengine.readwrite

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

CrawlType

Jenis crawl digunakan untuk membedakan antara refresh otomatis dan yang dipicu pengguna. Kecepatan crawl yang dipicu pengguna adalah untuk kasus penggunaan deterministik seperti crawling URL atau peta situs yang ditentukan oleh pengguna. Kecepatan crawl pemuatan ulang otomatis ditujukan untuk kasus penggunaan upaya terbaik seperti memuat ulang URL secara berkala.

Enum
CRAWL_TYPE_UNSPECIFIED Jenis crawl tidak ditentukan.
USER_TRIGGERED Jenis crawl dipicu oleh pengguna.
AUTO_REFRESH Jenis crawl adalah refresh otomatis.

Mode

Apakah tarif ditetapkan secara eksplisit oleh pengguna, atau ditetapkan oleh Vertex AI.

Enum
MODE_UNSPECIFIED Mode tidak ditentukan. Jika pengguna tidak menentukan mode, gunakan AUTOMATIC sebagai default.
AUTOMATIC Vertex AI secara otomatis membagi crawlRate menjadi yang dipicu pengguna dan refresh otomatis. Pengguna tidak perlu menentukan SetDedicatedCrawlRateRequest.CrawlType jika modenya adalah AUTOMATIC.
EXPLICIT Pengguna secara eksplisit menetapkan kecepatan crawl yang dipicu pengguna atau refresh otomatis.