Method: projects.locations.obtainCrawlRate

모니터링을 위해 자연 크롤링 또는 전용 크롤링 속도의 시계열 데이터를 가져옵니다. 전용 크롤링 속도가 설정되지 않은 경우 Vertex AI의 자연 크롤링 속도 시계열이 반환됩니다. 자연 크롤링은 Google이 자체적으로 인터넷을 자동으로 크롤링하는 것을 의미합니다. 전용 크롤링 속도가 설정되면 Vertex AI의 전용 크롤링 속도 시계열이 반환됩니다.

HTTP 요청

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

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

경로 매개변수

매개변수
location

string

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

요청 본문

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

JSON 표현 
{
  "crawlRateScope": string
}
필드
crawlRateScope

string

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

응답 본문

CrawlRateManagementService.ObtainCrawlRate 메서드의 응답 메시지입니다. 응답에는 전용 크롤링 속도가 설정되어 있는지에 따라 모니터링을 위한 자연 크롤링 또는 전용 크롤링 속도 시계열 데이터가 포함됩니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "state": enum (State),
  "error": {
    object (Status)
  },

  // Union field crawl_rate_time_series can be only one of the following:
  "organicCrawlRateTimeSeries": {
    object (OrganicCrawlRateTimeSeries)
  },
  "dedicatedCrawlRateTimeSeries": {
    object (DedicatedCrawlRateTimeSeries)
  }
  // End of list of possible types for union field crawl_rate_time_series.
}
필드
state

enum (State)

출력 전용입니다. 응답 상태입니다.
error

object (Status)

요청을 처리할 때 서비스에서 발생하는 오류입니다.
통합 필드 crawl_rate_time_series입니다. 사용자가 전용 크롤링 속도를 설정하면 전용 크롤링 속도 시계열이 반환되고, 그렇지 않으면 자연 크롤링 속도 시계열이 반환됩니다. crawl_rate_time_series은 다음 중 하나여야 합니다.
organicCrawlRateTimeSeries

object (OrganicCrawlRateTimeSeries)

모니터링에 사용되는 이전 자연 크롤링 속도 시계열 데이터입니다.
dedicatedCrawlRateTimeSeries

object (DedicatedCrawlRateTimeSeries)

모니터링에 사용되는 이전 전용 크롤링 속도 시계열 데이터입니다.

승인 범위

다음 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를 참조하세요.

OrganicCrawlRateTimeSeries

모니터링에 사용되는 이전 자연 크롤링 속도 시계열 데이터입니다. 자연 크롤링은 전용 크롤링이 설정되지 않은 경우 Google에서 사용자의 웹사이트를 크롤링하도록 자동으로 결정합니다. 크롤링 속도는 Google이 사용자의 웹사이트에 보내는 크롤링 요청의 QPS입니다.

JSON 표현 
{
  "googleOrganicCrawlRate": {
    object (CrawlRateTimeSeries)
  },
  "vertexAiOrganicCrawlRate": {
    object (CrawlRateTimeSeries)
  }
}
필드
googleOrganicCrawlRate

object (CrawlRateTimeSeries)

모든 googlebot의 크롤링 속도의 합계인 Google의 자연 크롤링 속도 시계열입니다. googlebot에 대한 자세한 내용은 https://developers.google.com/search/docs/crawling-indexing/overview-google-crawlers를 참조하세요.
vertexAiOrganicCrawlRate

object (CrawlRateTimeSeries)

전용 크롤링이 설정되지 않은 경우 Google-CloudVertexBot의 크롤링 속도인 Vertex AI의 자연 크롤링 속도 시계열입니다. Google-CloudVertexBot에 대한 자세한 내용은 https://developers.google.com/search/docs/crawling-indexing/google-common-crawlers#google-cloudvertexbot을 참조하세요.

CrawlRateTimeSeries

모니터링에 사용되는 이전 크롤링 속도 시계열 데이터입니다.

JSON 표현 
{
  "qpsTimeSeries": {
    object (TimeSeries)
  }
}
필드
qpsTimeSeries

object (TimeSeries)

크롤링 속도의 QPS입니다.

DedicatedCrawlRateTimeSeries

모니터링에 사용되는 이전 전용 크롤링 속도 시계열 데이터입니다. 전용 크롤링은 전용 크롤링이 설정된 경우 Vertex AI에서 사용자의 웹사이트를 크롤링하는 데 사용됩니다.

JSON 표현 
{
  "userTriggeredCrawlRate": {
    object (CrawlRateTimeSeries)
  },
  "autoRefreshCrawlRate": {
    object (CrawlRateTimeSeries)
  },
  "userTriggeredCrawlErrorRate": {
    object (CrawlRateTimeSeries)
  },
  "autoRefreshCrawlErrorRate": {
    object (CrawlRateTimeSeries)
  }
}
필드
userTriggeredCrawlRate

object (CrawlRateTimeSeries)

전용 크롤링이 설정된 경우 Google-CloudVertexBot의 크롤링 속도인 사용자 트리거 크롤링의 Vertex AI 전용 크롤링 속도 시계열입니다. 사용자 트리거 크롤링 속도는 사용자가 지정한 URL 또는 사이트맵 크롤링과 같은 결정적 사용 사례에 사용됩니다.
autoRefreshCrawlRate

object (CrawlRateTimeSeries)

전용 크롤링이 설정된 경우 Google-CloudVertexBot의 크롤링 속도인 자동 새로고침의 Vertex AI 전용 크롤링 속도 시계열입니다. 크롤링 속도는 URL을 주기적으로 새로고침하는 것과 같은 최선을 다하는 사용 사례에 사용됩니다.
userTriggeredCrawlErrorRate

object (CrawlRateTimeSeries)

사용자 트리거 전용 크롤링의 Vertex AI 오류율 시계열입니다.
autoRefreshCrawlErrorRate

object (CrawlRateTimeSeries)

자동 새로고침 전용 크롤링의 Vertex AI 오류율 시계열입니다.

주

다양한 응답 상태입니다.

열거형
STATE_UNSPECIFIED 상태가 지정되지 않았습니다.
SUCCEEDED 상태가 성공입니다.
FAILED 상태가 실패입니다.