Method: projects.locations.obtainCrawlRate

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

Permintaan HTTP

POST https://discoveryengine.googleapis.com/v1alpha/{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.

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, deret waktu frekuensi crawling khusus akan ditampilkan, atau deret waktu frekuensi crawling organik akan ditampilkan. crawl_rate_time_series hanya ada berupa salah satu diantara 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 crawl 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 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 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 disetel.

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 untuk crawl yang dipicu pengguna, yaitu frekuensi crawling Google-CloudVertexBot saat crawl 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 untuk refresh otomatis, yaitu frekuensi crawling Google-CloudVertexBot saat crawl khusus ditetapkan, dan frekuensi crawling 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 tingkat error Vertex AI untuk crawl khusus refresh otomatis.

Negara Bagian

Berbagai status respons.

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