Method: projects.locations.setDedicatedCrawlRate

Menetapkan frekuensi crawling khusus untuk crawlRateScope. Jika frekuensi crawling khusus tidak ditetapkan, tindakan ini akan memungkinkan bot crawl Vertex AI menggunakan frekuensi crawling khusus baru untuk crawling. Jika frekuensi crawling khusus ditetapkan, bot crawl Vertex AI akan mencoba memperbarui frekuensi crawling ke nilai baru. Jika nilai baru terlalu tinggi, bot crawl mungkin melakukan crawl dengan kecepatan yang lebih rendah untuk menghindari kelebihan beban 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 frekuensi crawling 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 frekuensi crawling 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 frekuensi crawling terlalu tinggi, QPS sebenarnya mungkin lebih rendah dari nilai yang ditetapkan oleh pengguna untuk menghindari kelebihan beban pada situs pengguna.
crawlType

enum (CrawlType)

Opsional. Apakah frekuensi crawling yang dipicu pengguna atau pemuatan ulang otomatis.
mode

enum (Mode)

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

Isi respons

Jika berhasil, isi respons akan memuat instance Operation.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.serving.readwrite

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

CrawlType

Jenis crawl digunakan untuk membedakan antara yang dipicu pengguna dan pemuatan ulang otomatis. Frekuensi crawling yang dipicu pengguna adalah untuk kasus penggunaan deterministik seperti melakukan crawling pada URL atau peta situs yang ditentukan oleh pengguna. Frekuensi crawling pembaruan otomatis adalah untuk kasus penggunaan upaya terbaik seperti memperbarui URL secara berkala.

Enum
CRAWL_TYPE_UNSPECIFIED Jenis crawl tidak ditentukan.
USER_TRIGGERED Jenis crawl dipicu pengguna.
AUTO_REFRESH Jenis crawl adalah pemuatan ulang otomatis.

Mode

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

Enum
MODE_UNSPECIFIED Mode tidak ditentukan. Jika pengguna tidak menentukan mode, setel ke AUTOMATIC secara default.
AUTOMATIC Vertex AI secara otomatis membagi crawlRate menjadi yang dipicu pengguna dan pemuatan ulang otomatis. Pengguna tidak perlu menentukan SetDedicatedCrawlRateRequest.CrawlType jika modenya adalah AUTOMATIC.
EXPLICIT Pengguna menetapkan frekuensi crawling yang dipicu pengguna atau pemuatan ulang otomatis secara eksplisit.