Method: projects.locations.setDedicatedCrawlRate

Establece la frecuencia de rastreo dedicada para un objeto crawlRateScope. Si no se configuró la frecuencia de rastreo dedicada, se habilitará el bot de rastreo de Vertex AI para que use la nueva frecuencia de rastreo dedicada para el rastreo. Si se estableció la frecuencia de rastreo dedicada, el bot de rastreo de Vertex AI intentará actualizar la frecuencia al valor nuevo. Si el valor nuevo es demasiado alto, es posible que el bot de rastreo rastree a una velocidad más baja para evitar sobrecargar el sitio web del usuario.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
location

string

Obligatorio. Es el recurso de ubicación en el que se realizará la administración de la frecuencia de rastreo. Formato: projects/{project}/locations/{location}

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "crawlRateScope": string,
  "crawlRate": integer,
  "crawlType": enum (CrawlType),
  "mode": enum (Mode)
}
Campos
crawlRateScope

string

Obligatorio. Es el alcance de la tasa de rastreo que el usuario desea configurar. Actualmente, solo se admiten el dominio y el nombre de host. Un ejemplo de nombre de dominio es example.com. Un ejemplo de nombre de host es www.example.com. No incluyas / en el nombre de dominio o de host.
crawlRate

integer

Es opcional. Son las QPS de rastreo que establece el usuario. No se garantiza que el robot de rastreo de Vertex rastree con este QPS. Si la frecuencia de rastreo es demasiado alta, es posible que el QPS real sea inferior al valor que estableció el usuario para evitar sobrecargar su sitio web.
crawlType

enum (CrawlType)

Es opcional. Indica si se trata de la frecuencia de rastreo activada por el usuario o la actualización automática.
mode

enum (Mode)

Es opcional. Indica si los usuarios establecen la tarifa de forma explícita o si la establece Vertex AI.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Operation.

Alcances de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

Para obtener más información, consulta Authentication Overview.

CrawlType

El tipo de rastreo se usa para distinguir entre las actualizaciones automáticas y las activadas por el usuario. La frecuencia de rastreo activada por el usuario se utiliza para casos de uso determinísticos, como el rastreo de URLs o mapas del sitio especificados por los usuarios. La frecuencia de rastreo de actualización automática es para casos de uso de mejor esfuerzo, como la actualización periódica de URLs.

Enums
CRAWL_TYPE_UNSPECIFIED No se especificó el tipo de rastreo.
USER_TRIGGERED El tipo de rastreo se activa por el usuario.
AUTO_REFRESH El tipo de rastreo es de actualización automática.

Modo

Indica si los usuarios establecen la tarifa de forma explícita o si la establece Vertex AI.

Enums
MODE_UNSPECIFIED No se especificó el modo. Si el usuario no especifica el modo, se usará el modo AUTOMATIC de forma predeterminada.
AUTOMATIC Vertex AI divide automáticamente crawlRate en activado por el usuario y actualización automática. Los usuarios no necesitan especificar SetDedicatedCrawlRateRequest.CrawlType si el modo es AUTOMATIC.
EXPLICIT Los usuarios establecen de forma explícita la frecuencia de rastreo activada por el usuario o de actualización automática.