Method: projects.locations.setDedicatedCrawlRate

Legt die dedizierte Crawling-Rate für einen crawlRateScope fest. Wenn die dedizierte Crawl-Rate nicht festgelegt wurde, kann der Crawl-Bot von Vertex AI die neue dedizierte Crawl-Rate für das Crawling verwenden. Wenn die dedizierte Crawling-Rate festgelegt wurde, versucht der Crawling-Bot von Vertex AI, die Rate auf den neuen Wert zu aktualisieren. Wenn der neue Wert zu hoch ist, wird die Website möglicherweise seltener gecrawlt, um eine Überlastung zu vermeiden.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
location

string

Erforderlich. Die Standortressource, in der die Crawl-Ratenverwaltung erfolgt. Format: projects/{project}/locations/{location}

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "crawlRateScope": string,
  "crawlRate": integer,
  "crawlType": enum (CrawlType),
  "mode": enum (Mode)
}
Felder
crawlRateScope

string

Erforderlich. Der Umfang der Crawling-Rate, die der Nutzer konfigurieren möchte. Derzeit werden nur Domain und Hostname unterstützt. Ein Beispiel für einen Domainnamen: example.com. Beispiel für einen Hostnamen: www.example.com. Fügen Sie / nicht in den Domain- oder Hostnamen ein.
crawlRate

integer

Optional. Die vom Nutzer festgelegte Crawl-QPS. Es wird nicht garantiert, dass der Vertex-Crawler-Bot mit dieser QPS crawlt. Wenn die Crawl-Rate zu hoch ist, kann die tatsächliche Anzahl der Anfragen pro Sekunde niedriger sein als der vom Nutzer festgelegte Wert, um eine Überlastung der Website des Nutzers zu vermeiden.
crawlType

enum (CrawlType)

Optional. Ob es sich um die Crawl-Rate von nutzergesteuerten oder automatischen Aktualisierungen handelt.
mode

enum (Mode)

Optional. Gibt an, ob die Rate explizit von Nutzern oder von Vertex AI festgelegt wird.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Operation.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentication Overview.

CrawlType

Der Crawl-Typ wird verwendet, um zwischen vom Nutzer ausgelösten und automatischen Aktualisierungen zu unterscheiden. Die vom Nutzer ausgelöste Crawling-Rate ist für deterministische Anwendungsfälle wie das Crawling von URLs oder Sitemaps vorgesehen, die von Nutzern angegeben werden. Die automatische Aktualisierungsrate ist für Best-Effort-Anwendungsfälle wie das regelmäßige Aktualisieren von URLs vorgesehen.

Enums
CRAWL_TYPE_UNSPECIFIED Der Crawl-Typ ist nicht angegeben.
USER_TRIGGERED Der Crawl-Typ ist nutzergesteuert.
AUTO_REFRESH Der Crawl-Typ ist „Automatische Aktualisierung“.

Modus

Gibt an, ob die Rate explizit von Nutzern oder von Vertex AI festgelegt wird.

Enums
MODE_UNSPECIFIED Der Modus ist nicht angegeben. Wenn der Nutzer den Modus nicht angibt, verwende AUTOMATIC als Standardeinstellung.
AUTOMATIC In Vertex AI wird die Crawl-Rate automatisch in nutzergesteuerte und automatische Aktualisierungen aufgeteilt. Nutzer müssen SetDedicatedCrawlRateRequest.CrawlType nicht angeben, wenn der Modus AUTOMATIC ist.
EXPLICIT Nutzer legen die Crawl-Rate für nutzergesteuerte oder automatische Aktualisierungen explizit fest.