Method: projects.locations.setDedicatedCrawlRate

Define a taxa de rastreio dedicada para um crawlRateScope. Se a taxa de rastreio dedicada não tiver sido definida, isto permite que o robot de rastreio da Vertex AI use a nova taxa de rastreio dedicada para o rastreio. Se a taxa de rastreio dedicada tiver sido definida, o robot de rastreio da Vertex AI tenta atualizar a taxa para o novo valor. Se o novo valor for demasiado elevado, o robot de rastreio pode rastrear a uma taxa mais baixa para evitar sobrecarregar o Website do utilizador.

Pedido HTTP

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

O URL usa a sintaxe de transcodificação de gRPC.

Parâmetros de caminho

Parâmetros
location

string

Obrigatório. O recurso de localização onde a gestão da taxa de rastreio vai ser realizada. Formato: projects/{project}/locations/{location}

Corpo do pedido

O corpo do pedido contém dados com a seguinte estrutura:

Representação JSON 
{
  "crawlRateScope": string,
  "crawlRate": integer,
  "crawlType": enum (CrawlType),
  "mode": enum (Mode)
}
Campos
crawlRateScope

string

Obrigatório. O âmbito da taxa de rastreio que o utilizador quer configurar. Atualmente, apenas são suportados o domínio e o nome do anfitrião. Um exemplo de nome de domínio: example.com. Um exemplo de nome do anfitrião: www.example.com. Não inclua / no domínio nem no nome do anfitrião.
crawlRate

integer

Opcional. O QPS de rastreio definido pelo utilizador. Não é garantido que o robot de rastreio do Vertex rastreie a esta QPS. Se a taxa de rastreio for demasiado elevada, o QPS real pode ser inferior ao valor definido pelo utilizador para evitar a sobrecarga do Website do utilizador.
crawlType

enum (CrawlType)

Opcional. Se é a taxa de rastreio acionada pelo utilizador ou a atualização automática.
mode

enum (Mode)

Opcional. Se a taxa é definida explicitamente pelos utilizadores ou pela Vertex AI.

Corpo da resposta

Se for bem-sucedido, o corpo da resposta contém uma instância de Operation.

Âmbitos de autorização

Requer um dos seguintes âmbitos do OAuth:

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

Para mais informações, consulte o Authentication Overview.

CrawlType

O tipo de rastreio é usado para distinguir o rastreio acionado pelo utilizador e a atualização automática. A taxa de rastreio acionada pelo utilizador destina-se a exemplos de utilização determinísticos, como o rastreio de URLs ou mapas do site especificados pelos utilizadores. A taxa de rastreio de atualização automática destina-se a exemplos de utilização de melhor esforço, como a atualização periódica de URLs.

Enumerações
CRAWL_TYPE_UNSPECIFIED O tipo de rastreio não foi especificado.
USER_TRIGGERED O tipo de rastreio é acionado pelo utilizador.
AUTO_REFRESH O tipo de rastreio é a atualização automática.

Modo

Se a taxa é definida explicitamente pelos utilizadores ou pela Vertex AI.

Enumerações
MODE_UNSPECIFIED O modo não está especificado. Se o utilizador não especificar o modo, o valor predefinido é AUTOMATIC.
AUTOMATIC A Vertex AI divide automaticamente a crawlRate em acionada pelo utilizador e atualização automática. Os utilizadores não precisam de especificar SetDedicatedCrawlRateRequest.CrawlType se o modo for AUTOMATIC.
EXPLICIT Os utilizadores definem explicitamente a taxa de rastreio acionada pelo utilizador ou de atualização automática.