Method: projects.locations.setDedicatedCrawlRate

Menetapkan frekuensi crawling khusus untuk crawlRateScope. Jika frekuensi crawling khusus tidak ditetapkan, opsi ini akan memungkinkan bot crawl Vertex AI menggunakan frekuensi crawling khusus yang 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 muatan pada situs pengguna.

Permintaan HTTP


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

URL ini menggunakan sintaksis 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 nama 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 daripada nilai yang ditetapkan oleh pengguna untuk menghindari kelebihan beban pada situs pengguna.
crawlType

enum (CrawlType)

Opsional. Apakah itu frekuensi crawling 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 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 refresh otomatis dan yang dipicu pengguna. Frekuensi crawling yang dipicu pengguna adalah untuk kasus penggunaan deterministik seperti meng-crawl 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 tarif ditetapkan secara eksplisit oleh pengguna, atau ditetapkan oleh Vertex AI.

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