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 mettre à jour la vitesse d'exploration avec la nouvelle valeur. Si la nouvelle valeur est trop élevée, le robot d'exploration peut explorer à un taux inférieur pour éviter de surcharger le site Web de l'utilisateur.

Requête HTTP

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

L'URL utilise 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. Champ d'application 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 ni dans le nom d'hôte.
crawlRate

integer

Facultatif. RPS d'exploration défini par l'utilisateur. Il n'est pas garanti que le robot d'exploration de Vertex explore à 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 le site Web de l'utilisateur.
crawlType

enum (CrawlType)

Facultatif. Indique s'il s'agit de la vitesse d'exploration déclenchée par l'utilisateur ou de l'actualisation automatique.
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 l'exploration déclenchée par l'utilisateur de l'actualisation automatique. La vitesse d'exploration déclenchée par l'utilisateur est destinée aux cas d'utilisation déterministes, comme l'exploration des URL ou des sitemaps spécifiés par les utilisateurs. La vitesse d'exploration d'actualisation automatique est destinée aux cas d'utilisation optimaux, 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 l'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, la valeur par défaut est AUTOMATIC.
AUTOMATIC Vertex AI divise automatiquement crawlRate en exploration déclenchée 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.