Method: projects.locations.setDedicatedCrawlRate

crawlRateScope의 전용 크롤링 속도를 설정합니다. 전용 크롤링 속도가 설정되지 않은 경우 Vertex AI의 크롤링 봇이 크롤링에 새 전용 크롤링 속도를 사용할 수 있도록 합니다. 전용 크롤링 속도가 설정된 경우 Vertex AI의 크롤링 봇이 속도를 새 값으로 업데이트하려고 시도합니다. 새 값이 너무 높으면 크롤링 봇이 사용자 웹사이트에 과부하가 걸리지 않도록 더 낮은 속도로 크롤링할 수 있습니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
location

string

(필수 항목) 크롤링 속도 관리가 수행될 위치 리소스입니다. 형식: projects/{project}/locations/{location}

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "crawlRateScope": string,
  "crawlRate": integer,
  "crawlType": enum (CrawlType),
  "mode": enum (Mode)
}
필드
crawlRateScope

string

(필수 항목) 사용자가 구성하려는 크롤링 속도의 범위입니다. 현재 도메인 및 호스트 이름만 지원됩니다. 도메인 이름 예시: example.com 호스트 이름 예시: www.example.com 도메인 또는 호스트 이름에 /을 포함하지 마세요.
crawlRate

integer

(선택사항) 사용자가 설정한 크롤링 QPS입니다. Vertex 크롤링 봇이 이 QPS로 크롤링한다는 보장은 없습니다. 크롤링 속도가 너무 높으면 사용자 웹사이트에 과부하가 걸리지 않도록 실제 QPS가 사용자가 설정한 값보다 낮을 수 있습니다.
crawlType

enum (CrawlType)

(선택사항) 사용자 트리거 또는 자동 새로고침의 크롤링 속도인지 여부입니다.
mode

enum (Mode)

(선택사항) 속도가 사용자에 의해 명시적으로 설정되는지 또는 Vertex AI에 의해 설정되는지 여부입니다.

응답 본문

성공한 경우 응답 본문에 Operation의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

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

자세한 내용은 Authentication Overview를 참고하세요.

CrawlType

크롤링 유형은 사용자 트리거 및 자동 새로고침을 구분하는 데 사용됩니다. 사용자 트리거 크롤링 속도는 사용자가 지정한 URL 또는 사이트맵 크롤링과 같은 결정적 사용 사례에 사용됩니다. 자동 새로고침 크롤링 속도는 URL을 주기적으로 새로고침하는 것과 같은 최선형 사용 사례에 사용됩니다.

열거형
CRAWL_TYPE_UNSPECIFIED 크롤링 유형이 지정되지 않았습니다.
USER_TRIGGERED 크롤링 유형은 사용자 트리거입니다.
AUTO_REFRESH 크롤링 유형은 자동 새로고침입니다.

모드

속도가 사용자에 의해 명시적으로 설정되는지 또는 Vertex AI에 의해 설정되는지 여부입니다.

열거형
MODE_UNSPECIFIED 모드가 지정되지 않았습니다. 사용자가 모드를 지정하지 않으면 기본값은 AUTOMATIC입니다.
AUTOMATIC Vertex AI는 crawlRate를 사용자 트리거 및 자동 새로고침으로 자동 분할합니다. 모드가 AUTOMATIC인 경우 사용자는 SetDedicatedCrawlRateRequest.CrawlType을 지정할 필요가 없습니다.
EXPLICIT 사용자가 사용자 트리거 또는 자동 새로고침 크롤링 속도를 명시적으로 설정합니다.