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

자세한 내용은 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 사용자가 사용자 트리거 또는 자동 새로고침 크롤링 빈도를 명시적으로 설정합니다.