Method: projects.locations.setDedicatedCrawlRate

Legt die dedizierte Crawling-Frequenz für einen „crawlRateScope“ fest. Wenn keine dedizierte Crawling-Frequenz festgelegt wurde, kann der Crawl-Bot von Vertex AI für das Crawling die neue dedizierte Crawling-Frequenz verwenden. Wenn die dedizierte Crawling-Frequenz festgelegt wurde, versucht der Crawl-Bot von Vertex AI, die Frequenz auf den neuen Wert zu aktualisieren. Ist der neue Wert zu hoch, crawlt der Crawl-Bot möglicherweise mit einer niedrigeren Frequenz, um die Website des Nutzers nicht zu überlasten.

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, wo die Crawling-Frequenz verwaltet wird. 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 Bereich der zu konfigurierenden Crawling-Frequenz. Aktuell werden nur Domain- und Hostnamen unterstützt. Ein Beispiel für einen Domainnamen: example.com. Ein Beispiel für einen Hostnamen: www.example.com. Fügen Sie in den Domain- oder Hostnamen keinen / ein.
crawlRate

integer

Optional. Die vom Nutzer festgelegten Abfragen pro Sekunde für das Crawling. Der Vertex-Crawl-Bot crawlt nicht zwingend mit dieser Abfragefrequenz. Ist die Crawling-Frequenz zu hoch, kann die tatsächliche Anzahl der Abfragen pro Sekunde niedriger sein als der vom Nutzer festgelegte Wert, um eine Überlastung der Website zu vermeiden.
crawlType

enum (CrawlType)

Optional. Gibt an, ob die Crawling-Frequenz vom Nutzer ausgelöst oder automatisch aktualisiert wird.
mode

enum (Mode)

Optional. Gibt an, ob die Frequenz explizit vom Nutzer 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 gibt an, ob die Crawling-Frequenz vom Nutzer ausgelöst oder automatisch aktualisiert wird. Die vom Nutzer ausgelöste Crawling-Frequenz ist für deterministische Anwendungsfälle wie Crawling-URLs oder Sitemaps vorgesehen, die von Nutzern angegeben werden. Die automatisch aktualisierte Crawling-Frequenz ist für Best-Effort-Anwendungsfälle wie das regelmäßige Aktualisieren von URLs vorgesehen.

Enums
CRAWL_TYPE_UNSPECIFIED Kein Crawl-Typ angegeben
USER_TRIGGERED Vom Nutzer ausgelöst
AUTO_REFRESH Automatisch aktualisiert

Mode

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

Enums
MODE_UNSPECIFIED Kein Modus angegeben. Wenn vom Nutzer kein Modus angegeben wird, wird standardmäßig AUTOMATIC verwendet.
AUTOMATIC Vertex AI teilt die „crawlRate“ dann automatisch in „vom Nutzer ausgelöst“ und „automatisch aktualisiert“ auf. Wenn der Modus AUTOMATIC lautet, müssen Nutzer SetDedicatedCrawlRateRequest.CrawlType nicht angeben.
EXPLICIT Nutzer legen die Crawling-Frequenz explizit als „vom Nutzer ausgelöst“ oder „automatisch aktualisiert“ fest.