Method: projects.locations.setDedicatedCrawlRate

Définit le taux d'exploration dédié pour un crawlRateScope. Si le taux d'exploration dédié n'a pas été défini, cela permettra au robot d'exploration de Vertex AI d'utiliser le nouveau taux d'exploration dédié 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 le taux 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/v1beta/{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 du taux 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 du taux 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 de Vertex explore à ce RPS. Si le taux d'exploration est trop élevé, 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 du taux d'exploration déclenché 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. Le taux d'exploration déclenché par l'utilisateur est destiné aux cas d'utilisation déterministes, comme l'exploration des URL ou des sitemaps spécifiés par les utilisateurs. Le taux d'exploration d'actualisation automatique est destiné 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 le taux d'exploration déclenché par l'utilisateur ou d'actualisation automatique.