Method: projects.locations.obtainCrawlRate

Mendapatkan data deret waktu rasio crawl organik atau khusus untuk pemantauan. Jika kecepatan crawl khusus tidak ditetapkan, deret waktu kecepatan crawl organik Vertex AI akan ditampilkan. Crawl organik berarti Google otomatis meng-crawl internet sesuai keinginannya sendiri. Jika frekuensi crawling khusus ditetapkan, deret waktu frekuensi crawling khusus Vertex AI akan ditampilkan.

Permintaan HTTP

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

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
location

string

Wajib. Resource lokasi tempat pengelolaan kecepatan crawl akan dilakukan. Format: projects/{project}/locations/{location}

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "crawlRateScope": string
}
Kolom
crawlRateScope

string

Wajib. Cakupan kecepatan crawl yang ingin dipantau pengguna. Saat ini, hanya nama domain dan host yang didukung. Contoh nama domain: example.com. Contoh nama host: www.example.com. Jangan sertakan / dalam nama domain atau host.

Isi respons

Pesan respons untuk metode CrawlRateManagementService.ObtainCrawlRate. Respons berisi data deret waktu kecepatan crawl organik atau khusus untuk pemantauan, bergantung pada apakah kecepatan crawl khusus ditetapkan.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "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.
}
Kolom
state

enum (State)

Hanya output. Status respons.
error

object (Status)

Error dari layanan saat menangani permintaan.
Kolom union crawl_rate_time_series. Setelah pengguna menetapkan kecepatan crawl khusus, deret waktu kecepatan crawl khusus akan ditampilkan, atau deret waktu kecepatan crawl organik akan ditampilkan. crawl_rate_time_series hanya ada berupa salah satu diantara berikut:
organicCrawlRateTimeSeries

object (OrganicCrawlRateTimeSeries)

Data deret waktu rasio crawl organik historis, yang digunakan untuk pemantauan.
dedicatedCrawlRateTimeSeries

object (DedicatedCrawlRateTimeSeries)

Data deret waktu kecepatan crawl khusus historis, yang digunakan untuk pemantauan.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

OrganicCrawlRateTimeSeries

Data deret waktu rasio crawl organik historis, yang digunakan untuk pemantauan. Crawling organik ditentukan secara otomatis oleh Google untuk meng-crawl situs pengguna saat crawling khusus tidak ditetapkan. Kecepatan crawl adalah QPS permintaan crawl yang dikirim Google ke situs pengguna.

Representasi JSON 
{
  "googleOrganicCrawlRate": {
    object (CrawlRateTimeSeries)
  },
  "vertexAiOrganicCrawlRate": {
    object (CrawlRateTimeSeries)
  }
}
Kolom
googleOrganicCrawlRate

object (CrawlRateTimeSeries)

Deret waktu kecepatan crawling organik Google, yang merupakan jumlah kecepatan crawling semua googlebot. Lihat https://developers.google.com/search/docs/crawling-indexing/overview-google-crawlers untuk mengetahui detail selengkapnya tentang googlebot.
vertexAiOrganicCrawlRate

object (CrawlRateTimeSeries)

Deret waktu kecepatan crawl organik Vertex AI, yaitu kecepatan crawl Google-CloudVertexBot saat crawl khusus tidak ditetapkan. Lihat https://developers.google.com/search/docs/crawling-indexing/google-common-crawlers#google-cloudvertexbot untuk mengetahui detail selengkapnya tentang Google-CloudVertexBot.

CrawlRateTimeSeries

Data deret waktu kecepatan crawl historis, yang digunakan untuk pemantauan.

Representasi JSON 
{
  "qpsTimeSeries": {
    object (TimeSeries)
  }
}
Kolom
qpsTimeSeries

object (TimeSeries)

QPS kecepatan crawl.

DedicatedCrawlRateTimeSeries

Data deret waktu kecepatan crawl khusus historis, yang digunakan untuk pemantauan. Crawling khusus digunakan oleh Vertex AI untuk meng-crawl situs pengguna saat crawling khusus disetel.

Representasi JSON 
{
  "userTriggeredCrawlRate": {
    object (CrawlRateTimeSeries)
  },
  "autoRefreshCrawlRate": {
    object (CrawlRateTimeSeries)
  },
  "userTriggeredCrawlErrorRate": {
    object (CrawlRateTimeSeries)
  },
  "autoRefreshCrawlErrorRate": {
    object (CrawlRateTimeSeries)
  }
}
Kolom
userTriggeredCrawlRate

object (CrawlRateTimeSeries)

Deret waktu kecepatan crawl khusus Vertex AI untuk crawl yang dipicu pengguna, yaitu kecepatan crawl Google-CloudVertexBot saat crawl khusus ditetapkan, dan kecepatan crawl yang dipicu pengguna adalah untuk kasus penggunaan deterministik seperti meng-crawl URL atau peta situs yang ditentukan oleh pengguna.
autoRefreshCrawlRate

object (CrawlRateTimeSeries)

Deret waktu kecepatan crawl khusus Vertex AI yang diperbarui otomatis, yaitu kecepatan crawl Google-CloudVertexBot saat crawl khusus ditetapkan, dan kecepatan crawl untuk kasus penggunaan upaya terbaik seperti memperbarui URL secara berkala.
userTriggeredCrawlErrorRate

object (CrawlRateTimeSeries)

Deret waktu tingkat error Vertex AI untuk crawl khusus yang dipicu pengguna.
autoRefreshCrawlErrorRate

object (CrawlRateTimeSeries)

Deret waktu rasio error Vertex AI untuk crawl khusus refresh otomatis.

Negara bagian/Provinsi

Berbagai status respons.

Enum
STATE_UNSPECIFIED Status tidak ditentukan.
SUCCEEDED Statusnya berhasil.
FAILED Statusnya gagal.