Method: projects.locations.setDedicatedCrawlRate

Définit la vitesse d'exploration dédiée pour un crawlRateScope. Si la vitesse d'exploration dédiée n'a pas été définie, cela permettra au robot d'exploration de Vertex AI d'utiliser la nouvelle vitesse d'exploration dédiée pour l'exploration. Si le taux d'exploration dédié a été défini, le robot d'exploration de Vertex AI tentera de le modifier. Si la nouvelle valeur est trop élevée, le robot d'exploration peut explorer le site à un rythme plus lent pour éviter de le surcharger.

Requête HTTP


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

Les URL utilisent la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
location

string

Obligatoire. Ressource d'emplacement où la gestion de la vitesse d'exploration sera effectuée. Format : projects/{project}/locations/{location}

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "crawlRateScope": string,
  "crawlRate": integer,
  "crawlType": enum (CrawlType),
  "mode": enum (Mode)
}
Champs
crawlRateScope

string

Obligatoire. Portée de la vitesse d'exploration que l'utilisateur souhaite configurer. Actuellement, seuls le nom de domaine et le nom d'hôte sont acceptés. Exemple de nom de domaine : example.com. Exemple de nom d'hôte : www.example.com. Veuillez ne pas inclure / dans le nom de domaine ou d'hôte.
crawlRate

integer

Facultatif. RPS d'exploration défini par l'utilisateur. Il n'est pas garanti que le robot d'exploration Vertex explorera à ce RPS. Si la vitesse d'exploration est trop élevée, le RPS réel peut être inférieur à la valeur définie par l'utilisateur pour éviter de surcharger son site Web.
crawlType

enum (CrawlType)

Facultatif. Qu'il s'agisse de la vitesse d'exploration des actualisations déclenchées par l'utilisateur ou automatiques.
mode

enum (Mode)

Facultatif. Indique si le taux est défini explicitement par les utilisateurs ou par Vertex AI.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Operation.

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

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

Pour plus d'informations, consultez la Authentication Overview.

CrawlType

Le type d'exploration permet de distinguer les actualisations déclenchées par l'utilisateur de celles qui sont automatiques. Le taux d'exploration déclenché par l'utilisateur est destiné aux cas d'utilisation déterministes, comme l'exploration d'URL ou de sitemaps spécifiés par les utilisateurs. La vitesse d'exploration avec actualisation automatique est destinée aux cas d'utilisation les plus efficaces, comme l'actualisation périodique des URL.

Enums
CRAWL_TYPE_UNSPECIFIED Le type d'exploration n'est pas spécifié.
USER_TRIGGERED Le type d'exploration est déclenché par l'utilisateur.
AUTO_REFRESH Le type d'exploration est "Actualisation automatique".

Mode

Indique si le taux est défini explicitement par les utilisateurs ou par Vertex AI.

Enums
MODE_UNSPECIFIED Le mode n'est pas spécifié. Si l'utilisateur ne spécifie pas le mode, définissez AUTOMATIC par défaut.
AUTOMATIC Vertex AI divise automatiquement crawlRate en "déclenchement par l'utilisateur" et "actualisation automatique". Les utilisateurs n'ont pas besoin de spécifier SetDedicatedCrawlRateRequest.CrawlType si le mode est AUTOMATIC.
EXPLICIT Les utilisateurs définissent explicitement la vitesse d'exploration déclenchée par l'utilisateur ou l'actualisation automatique.