Method: projects.locations.setDedicatedCrawlRate

Define la frecuencia de rastreo dedicada de un crawlRateScope. Si no se ha definido la frecuencia de rastreo dedicada, se permitirá que el robot de rastreo de Vertex AI use la nueva frecuencia de rastreo dedicada para rastrear. Si se ha definido una frecuencia de rastreo específica, el robot de rastreo de Vertex AI intentará actualizar la frecuencia al nuevo valor. Si el nuevo valor es demasiado alto, el robot de rastreo puede rastrear a una velocidad inferior para evitar sobrecargar el sitio web del usuario.

Solicitud HTTP

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

La URL utiliza la sintaxis de transcodificación a gRPC.

Parámetros de ruta

Parámetros
location

string

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

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos que presentan la siguiente estructura:

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

string

Obligatorio. El alcance de la frecuencia de rastreo que quiere configurar el usuario. Actualmente, solo se admiten el dominio y el nombre de host. Por ejemplo, example.com. Por ejemplo, www.example.com. No incluyas / en el nombre de dominio o de host.
crawlRate

integer

Opcional. Las CPS de rastreo definidas por el usuario. No se garantiza que el robot de rastreo de Vertex rastree a este QPS. Si la frecuencia de rastreo es demasiado alta, es posible que las QPS reales sean inferiores al valor definido por el usuario para evitar sobrecargar el sitio web del usuario.
crawlType

enum (CrawlType)

Opcional. Si se trata de la frecuencia de rastreo activada por el usuario o de la actualización automática.
mode

enum (Mode)

Opcional. Indica si los usuarios han definido la tarifa explícitamente o si la ha definido Vertex AI.

Cuerpo de la respuesta

Si la solicitud se hace correctamente, en el cuerpo de la respuesta se incluye una instancia de Operation.

Permisos de autorización

Debes disponer de uno de los siguientes permisos de OAuth:

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

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

CrawlType

El tipo de rastreo se usa para distinguir entre los rastreos activados por el usuario y los que se actualizan automáticamente. La frecuencia de rastreo activada por el usuario se usa en casos deterministas, como rastrear URLs o mapas del sitio especificados por los usuarios. La frecuencia de rastreo de actualización automática se usa en casos en los que se hace el mejor esfuerzo posible, como la actualización periódica de URLs.

Enumeraciones
CRAWL_TYPE_UNSPECIFIED El tipo de rastreo no está especificado.
USER_TRIGGERED El tipo de rastreo es activado por el usuario.
AUTO_REFRESH El tipo de rastreo es de actualización automática.

Modo

Indica si los usuarios han definido la tarifa explícitamente o si la ha definido Vertex AI.

Enumeraciones
MODE_UNSPECIFIED El modo no está especificado. Si el usuario no especifica el modo, se usará el valor predeterminado AUTOMATIC.
AUTOMATIC Vertex AI divide automáticamente crawlRate en activado por el usuario y actualización automática. Los usuarios no tienen que especificar SetDedicatedCrawlRateRequest.CrawlType si el modo es AUTOMATIC.
EXPLICIT Los usuarios definen explícitamente la frecuencia de rastreo activada por el usuario o la frecuencia de actualización automática.