Method: projects.locations.obtainCrawlRate

Ruft die Zeitreihendaten für die organische oder dedizierte Crawling-Frequenz zu Monitoringzwecken ab. Wenn keine dedizierte Crawling-Frequenz festgelegt wurde, wird die Zeitreihe für die organische Crawling-Frequenz von Vertex AI zurückgegeben. Beim organischen Crawling durchsucht Google das Internet automatisch nach eigenem Ermessen. Wenn eine dedizierte Crawling-Frequenz festgelegt wurde, wird die Zeitreihe für die dedizierte Crawling-Frequenz von Vertex AI zurückgegeben.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
location

string

Erforderlich. Die Standortressource, mit der die Crawling-Frequenz verwaltet wird. 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 zu überwachenden Crawling-Frequenz. Derzeit werden nur Domain- und Hostnamen unterstützt. Beispiel für einen Domainnamen: example.com. Beispiel für einen Hostnamen: www.example.com. Fügen Sie keinen / in den Domain- oder Hostnamen ein.

Antworttext

Antwortnachricht für die Methode CrawlRateManagementService.ObtainCrawlRate. Die Antwort enthält Zeitreihendaten der organischen bzw. dedizierten Crawling-Frequenz für das Monitoring, je nachdem, ob eine dedizierte Crawling-Frequenz festgelegt wurde.

Wenn der Vorgang erfolgreich abgeschlossen wurde, 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)

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

object (OrganicCrawlRateTimeSeries)

Der Zeitreihenverlauf für die zu überwachende organische Crawling-Frequenz.
dedicatedCrawlRateTimeSeries

object (DedicatedCrawlRateTimeSeries)

Der Zeitreihenverlauf für die zu überwachende dedizierte Crawling-Frequenz.

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

Der Zeitreihenverlauf für die zu überwachende organische Crawling-Frequenz. Das organische Crawling wird von Google automatisch festgelegt, um die Website des Nutzers zu durchsuchen, wenn kein dediziertes Crawling festgelegt wurde. Die Crawling-Frequenz ist die Anzahl der Crawl-Abfragen pro Sekunde, die Google an die Website des Nutzers sendet.

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

object (CrawlRateTimeSeries)

Die Zeitreihe der organischen Crawling-Frequenz von Google. Sie entspricht der Summe der Crawling-Frequenz aller Googlebots. Weitere Informationen zu Googlebots finden Sie unter https://developers.google.com/search/docs/crawling-indexing/overview-google-crawlers.
vertexAiOrganicCrawlRate

object (CrawlRateTimeSeries)

Die Zeitreihe der organischen Crawling-Frequenz von Vertex AI. Sie entspricht der Crawling-Frequenz von Google-CloudVertexBot, wenn kein dediziertes Crawling festgelegt wurde. Weitere Informationen zu Google-CloudVertexBot finden Sie unter https://developers.google.com/search/docs/crawling-indexing/google-common-crawlers#google-cloudvertexbot.

CrawlRateTimeSeries

Die Zeitreihenverlauf für die zu überwachende Crawling-Frequenz.

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

object (TimeSeries)

Die Abfragen pro Sekunde (QPS) der Crawling-Frequenz.

DedicatedCrawlRateTimeSeries

Der Zeitreihenverlauf für die zu überwachende dedizierte Crawling-Frequenz. Die Website des Nutzers wird von Vertex AI mit dediziertem Crawling durchsucht, wenn dies entsprechend festgelegt wurde.

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

object (CrawlRateTimeSeries)

Die Zeitreihe für die dedizierte Crawling-Frequenz von Vertex AI für nutzergesteuertes Crawling. Dies ist die Crawling-Frequenz von Google-CloudVertexBot, wenn dediziertes Crawling festgelegt wurde. Die nutzergesteuerte Crawling-Frequenz ist für deterministische Anwendungsfälle wie Crawling-URLs oder Sitemaps vorgesehen, die von Nutzern angegeben werden.
autoRefreshCrawlRate

object (CrawlRateTimeSeries)

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

object (CrawlRateTimeSeries)

Die Zeitreihe für die Fehlerrate von Vertex AI für nutzergesteuertes dediziertes Crawling.
autoRefreshCrawlErrorRate

object (CrawlRateTimeSeries)

Die Zeitreihe für die Fehlerrate von Vertex AI für dediziertes Crawling mit automatischer Aktualisierung.

State

Verschiedene Status der Antwort.

Enums
STATE_UNSPECIFIED Kein Status angegeben.
SUCCEEDED Status: Erfolgreich.
FAILED Status: Fehler.