Method: projects.locations.obtainCrawlRate

Ruft die Zeitreihendaten der organischen oder dedizierten Crawl-Rate zur Überwachung ab. Wenn keine dedizierte Crawl-Rate festgelegt ist, wird die Zeitreihe der organischen Crawl-Rate von Vertex AI zurückgegeben. Beim organischen Crawling durchsucht Google das Internet automatisch nach eigenem Ermessen. Wenn eine dedizierte Crawling-Geschwindigkeit festgelegt ist, wird die Zeitreihe für die dedizierte Crawling-Geschwindigkeit von Vertex AI zurückgegeben.

HTTP-Anfrage

POST https://discoveryengine.googleapis.com/v1beta/{location=projects/*/locations/*}:obtainCrawlRate

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
}
Felder
crawlRateScope

string

Erforderlich. Der Bereich der Crawl-Rate, den der Nutzer überwachen 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.

Antworttext

Antwortnachricht für die Methode CrawlRateManagementService.ObtainCrawlRate. Die Antwort enthält Zeitreihendaten zur organischen oder dedizierten Crawling-Rate für die Überwachung, je nachdem, ob eine dedizierte Crawling-Rate festgelegt ist.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "state": enum (State),
  "error": {
    object (Status)
  },

  // Union field crawl_rate_time_series can be only one of the following:
  "organicCrawlRateTimeSeries": {
    object (OrganicCrawlRateTimeSeries)
  },
  "dedicatedCrawlRateTimeSeries": {
    object (DedicatedCrawlRateTimeSeries)
  }
  // End of list of possible types for union field crawl_rate_time_series.
}
Felder
state

enum (State)

Nur Ausgabe. Der Status der Antwort.
error

object (Status)

Fehler vom Dienst bei der Verarbeitung der Anfrage.
Union-Feld crawl_rate_time_series. Sobald der Nutzer die dedizierte Crawling-Frequenz festgelegt hat, wird die Zeitreihe für die dedizierte Crawling-Frequenz zurückgegeben. Andernfalls wird die Zeitreihe für die organische Crawling-Frequenz zurückgegeben. Für crawl_rate_time_series ist nur einer der folgenden Werte zulässig:
organicCrawlRateTimeSeries

object (OrganicCrawlRateTimeSeries)

Die Zeitreihendaten zur bisherigen organischen Crawling-Rate, die für das Monitoring verwendet werden.
dedicatedCrawlRateTimeSeries

object (DedicatedCrawlRateTimeSeries)

Die Zeitreihendaten zur historischen dedizierten Crawling-Rate, die für das Monitoring verwendet werden.

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.

OrganicCrawlRateTimeSeries

Die Zeitreihendaten zur bisherigen organischen Crawling-Rate, die für das Monitoring verwendet werden. Das organische Crawling wird automatisch von Google festgelegt, um die Website des Nutzers zu crawlen, wenn kein dediziertes Crawling festgelegt ist. Die Crawl-Rate ist die Anzahl der Crawl-Anfragen pro Sekunde, die Google an die Website des Nutzers sendet.

JSON-Darstellung 
{
  "googleOrganicCrawlRate": {
    object (CrawlRateTimeSeries)
  },
  "vertexAiOrganicCrawlRate": {
    object (CrawlRateTimeSeries)
  }
}
Felder
googleOrganicCrawlRate

object (CrawlRateTimeSeries)

Die Zeitreihe für die organische Crawling-Frequenz von Google, die die Summe der Crawling-Frequenz aller Googlebots ist. Weitere Informationen zu Googlebots finden Sie unter https://developers.google.com/search/docs/crawling-indexing/overview-google-crawlers.
vertexAiOrganicCrawlRate

object (CrawlRateTimeSeries)

Die Zeitreihe für die organische Crawl-Rate von Vertex AI. Das ist die Crawl-Rate von Google-CloudVertexBot, wenn kein dediziertes Crawling festgelegt ist. Weitere Informationen zu Google-CloudVertexBot finden Sie unter https://developers.google.com/search/docs/crawling-indexing/google-common-crawlers#google-cloudvertexbot.

CrawlRateTimeSeries

Die Zeitreihendaten zur bisherigen Crawl-Rate, die für das Monitoring verwendet werden.

JSON-Darstellung 
{
  "qpsTimeSeries": {
    object (TimeSeries)
  }
}
Felder
qpsTimeSeries

object (TimeSeries)

Die QPS der Crawling-Frequenz.

DedicatedCrawlRateTimeSeries

Die Zeitreihendaten zur historischen dedizierten Crawling-Rate, die für das Monitoring verwendet werden. Der dedizierte Crawl wird von Vertex AI verwendet, um die Website des Nutzers zu crawlen, wenn er festgelegt ist.

JSON-Darstellung 
{
  "userTriggeredCrawlRate": {
    object (CrawlRateTimeSeries)
  },
  "autoRefreshCrawlRate": {
    object (CrawlRateTimeSeries)
  },
  "userTriggeredCrawlErrorRate": {
    object (CrawlRateTimeSeries)
  },
  "autoRefreshCrawlErrorRate": {
    object (CrawlRateTimeSeries)
  }
}
Felder
userTriggeredCrawlRate

object (CrawlRateTimeSeries)

Die dedizierte Zeitreihe für die Crawl-Rate von Vertex AI für nutzergesteuerte Crawls ist die Crawl-Rate von Google-CloudVertexBot, wenn die dedizierte Crawl-Rate festgelegt ist. Die nutzergesteuerte Crawl-Rate ist für deterministische Anwendungsfälle wie das Crawlen von URLs oder Sitemaps, die von Nutzern angegeben werden.
autoRefreshCrawlRate

object (CrawlRateTimeSeries)

Die dedizierte Zeitreihe für die Crawling-Rate von Vertex AI für das automatische Aktualisieren. Dies ist die Crawling-Rate von Google-CloudVertexBot, wenn das dedizierte Crawling festgelegt ist. Die Crawling-Rate ist für Best-Effort-Anwendungsfälle wie das regelmäßige Aktualisieren von URLs vorgesehen.
userTriggeredCrawlErrorRate

object (CrawlRateTimeSeries)

Die Zeitreihe der Fehlerrate von Vertex AI für einen vom Nutzer ausgelösten dedizierten Crawl.
autoRefreshCrawlErrorRate

object (CrawlRateTimeSeries)

Die Zeitachse der Fehlerrate für den Crawl mit automatischer Aktualisierung in Vertex AI.

Bundesland

Verschiedene Status der Antwort.

Enums
STATE_UNSPECIFIED Der Zustand ist unspezifisch.
SUCCEEDED Der Status ist „Erfolgreich“.
FAILED Der Status ist „Fehler“.