Method: projects.locations.setDedicatedCrawlRate

Define a taxa de rastreamento dedicada para um crawlRateScope. Se a taxa de rastreamento dedicada não tiver sido definida, isso permitirá que o bot de rastreamento da Vertex AI use a nova taxa de rastreamento dedicada para rastreamento. Se a taxa de rastreamento dedicada tiver sido definida, o bot de rastreamento da Vertex AI vai tentar atualizar a taxa para o novo valor. Se o novo valor for muito alto, o bot de rastreamento poderá rastrear a uma taxa mais baixa para evitar sobrecarregar o site do usuário.

Solicitação HTTP

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

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

Parâmetros de caminho

Parâmetros
location

string

Obrigatório. O recurso de local em que o gerenciamento da taxa de rastreamento será realizado. Formato: projects/{project}/locations/{location}

Corpo da solicitação

O corpo da solicitação 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 escopo da taxa de rastreamento que o usuário quer configurar. No momento, apenas o domínio e o nome do host são aceitos. Exemplo de nome de domínio: example.com. Exemplo de nome do host: www.example.com. Não inclua / no domínio ou no nome do host.
crawlRate

integer

Opcional. O QPS de rastreamento definido pelo usuário. Não há garantia de que o bot de rastreamento da Vertex vai rastrear nesse QPS. Se a taxa de rastreamento for muito alta, o QPS real poderá ser menor que o valor definido pelo usuário para evitar sobrecarregar o site dele.
crawlType

enum (CrawlType)

Opcional. Se é a taxa de rastreamento acionada pelo usuário ou a atualização automática.
mode

enum (Mode)

Opcional. Se a taxa é definida explicitamente pelos usuários ou pela Vertex AI.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Operation.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte Authentication Overview.

CrawlType

O tipo de rastreamento é usado para distinguir o rastreamento acionado pelo usuário e a atualização automática. A taxa de rastreamento acionada pelo usuário é para casos de uso determinísticos, como rastrear URLs ou sitemaps especificados pelos usuários. A taxa de rastreamento de atualização automática é para casos de uso de melhor esforço, como atualizar URLs periodicamente.

Tipos enumerados
CRAWL_TYPE_UNSPECIFIED O tipo de rastreamento não foi especificado.
USER_TRIGGERED O tipo de rastreamento é acionado pelo usuário.
AUTO_REFRESH O tipo de rastreamento é de atualização automática.

Moda

Se a taxa é definida explicitamente pelos usuários ou pela Vertex AI.

Tipos enumerados
MODE_UNSPECIFIED O modo não foi especificado. Se o usuário não especificar o modo, o padrão será AUTOMATIC.
AUTOMATIC A Vertex AI divide automaticamente o crawlRate em acionado pelo usuário e atualização automática. Os usuários não precisam especificar SetDedicatedCrawlRateRequest.CrawlType se o modo for AUTOMATIC.
EXPLICIT Os usuários definem explicitamente a taxa de rastreamento acionada pelo usuário ou a atualização automática.