Method: projects.locations.obtainCrawlRate

Mendapatkan data deret waktu dari frekuensi crawling organik atau khusus untuk pemantauan. Jika frekuensi crawling khusus tidak ditetapkan, fungsi ini akan menampilkan deret waktu frekuensi crawling organik Vertex AI. Crawling organik berarti Google otomatis meng-crawl internet sesuai keinginannya sendiri. Jika frekuensi crawling khusus ditetapkan, fungsi ini akan menampilkan deret waktu frekuensi crawling khusus Vertex AI.

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 frekuensi crawling 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 frekuensi crawling 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 frekuensi crawling organik atau khusus untuk pemantauan, bergantung pada apakah frekuensi crawling khusus ditetapkan atau tidak.

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 frekuensi crawling khusus, fungsi ini akan menampilkan deret waktu frekuensi crawling khusus. Jika tidak, fungsi ini akan menampilkan deret waktu frekuensi crawling organik. crawl_rate_time_series hanya dapat berupa salah satu dari berikut:
organicCrawlRateTimeSeries

object (OrganicCrawlRateTimeSeries)

Data deret waktu frekuensi crawling organik historis, yang digunakan untuk pemantauan.
dedicatedCrawlRateTimeSeries

object (DedicatedCrawlRateTimeSeries)

Data deret waktu frekuensi crawling 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
  • https://www.googleapis.com/auth/discoveryengine.serving.readwrite

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

OrganicCrawlRateTimeSeries

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

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

object (CrawlRateTimeSeries)

Deret waktu frekuensi crawling organik Google, yang merupakan jumlah frekuensi 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 frekuensi crawling organik Vertex AI, yang merupakan frekuensi crawling Google-CloudVertexBot saat crawling 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 frekuensi crawling historis, yang digunakan untuk pemantauan.

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

object (TimeSeries)

QPS frekuensi crawling.

DedicatedCrawlRateTimeSeries

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

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

object (CrawlRateTimeSeries)

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

object (CrawlRateTimeSeries)

Deret waktu frekuensi crawling khusus Vertex AI dari refresh otomatis, yang merupakan frekuensi crawling Google-CloudVertexBot saat crawling khusus ditetapkan, dan frekuensi crawling adalah untuk kasus penggunaan upaya terbaik seperti memperbarui URL secara berkala.
userTriggeredCrawlErrorRate

object (CrawlRateTimeSeries)

Deret waktu tingkat error Vertex AI dari crawling khusus yang dipicu pengguna.
autoRefreshCrawlErrorRate

object (CrawlRateTimeSeries)

Deret waktu tingkat error Vertex AI dari crawling khusus refresh otomatis.

Status

Status respons yang berbeda.

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