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 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)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "organicCrawlRateTimeSeries": {
    object (OrganicCrawlRateTimeSeries)
  },
  "dedicatedCrawlRateTimeSeries": {
    object (DedicatedCrawlRateTimeSeries)
  }
  // End of mutually exclusive fields.
}
Kolom
state

enum (State)

Hanya output. Status respons.
error

object (Status)

Error dari layanan saat menangani permintaan.
Setelah pengguna menetapkan frekuensi crawling khusus, API ini akan menampilkan deret waktu frekuensi crawling khusus, atau menampilkan deret waktu frekuensi crawling organik. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
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.
Akhir kolom yang saling eksklusif.

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 dari semua frekuensi crawling 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 yang diperbarui 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.