Method: projects.locations.setDedicatedCrawlRate

הגדרת קצב סריקה ייעודי ל-crawlRateScope. אם לא הוגדר קצב סריקה ייעודי, הפעולה הזו תאפשר לבוט הסריקה של Vertex AI להשתמש בקצב הסריקה הייעודי החדש לסריקה. אם הוגדר קצב סריקה ייעודי, בוט הסריקה של Vertex AI ינסה לעדכן את הקצב לערך החדש. אם הערך החדש גבוה מדי, יכול להיות שבוט הסריקה יסרוק בקצב נמוך יותר כדי למנוע עומס יתר על האתר של המשתמש.

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
location

string

חובה. משאב המיקום שבו יתבצע ניהול קצב הסריקה. פורמט: projects/{project}/locations/{location}

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "crawlRateScope": string,
  "crawlRate": integer,
  "crawlType": enum (CrawlType),
  "mode": enum (Mode)
}
שדות
crawlRateScope

string

חובה. ההיקף של קצב הסריקה שהמשתמש רוצה להגדיר. בשלב הזה יש תמיכה רק בדומיין ובשם המארח. דוגמה לשם דומיין: example.com. דוגמה לשם מארח: www.example.com. אל תכללו את / בשם הדומיין או בשם המארח.
crawlRate

integer

זה שינוי אופציונלי. מספר השאילתות לשנייה שנקבע על ידי המשתמש. אין ערובה לכך ש-Vertex crawl bot יסרוק בקצב הזה של QPS. אם קצב הסריקה גבוה מדי, יכול להיות שערך ה-QPS בפועל יהיה נמוך מהערך שהמשתמש הגדיר, כדי למנוע עומס יתר על האתר של המשתמש.
crawlType

enum (CrawlType)

זה שינוי אופציונלי. אם מדובר בקצב הסריקה של רענון אוטומטי או של רענון שהופעל על ידי משתמש.
mode

enum (Mode)

זה שינוי אופציונלי. האם השיעור מוגדר באופן מפורש על ידי המשתמשים או על ידי Vertex AI.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של Operation.

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

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

ניתן למצוא מידע נוסף כאן: Authentication Overview.

CrawlType

סוג הסריקה משמש להבחנה בין סריקה שהופעלה על ידי המשתמש לבין רענון אוטומטי. קצב הסריקה שמופעל על ידי המשתמשים מיועד לתרחישי שימוש דטרמיניסטיים, כמו סריקה של כתובות URL או מפות אתרים שצוינו על ידי המשתמשים. קצב הסריקה ברענון אוטומטי מיועד לתרחישי שימוש שבהם נדרש מאמץ מרבי, כמו רענון של כתובות URL באופן תקופתי.

טיפוסים בני מנייה (enum)
CRAWL_TYPE_UNSPECIFIED סוג הסריקה לא צוין.
USER_TRIGGERED סוג הסריקה הוא סריקה שהמשתמש מפעיל.
AUTO_REFRESH סוג הסריקה הוא רענון אוטומטי.

מצב

האם השיעור מוגדר באופן מפורש על ידי המשתמשים או על ידי Vertex AI.

טיפוסים בני מנייה (enum)
MODE_UNSPECIFIED המצב לא צוין. אם המשתמש לא מציין את המצב, ברירת המחדל היא AUTOMATIC.
AUTOMATIC ‫Vertex AI מפצל באופן אוטומטי את crawlRate ל-user-triggered ול-auto-refresh. המשתמשים לא צריכים לציין את SetDedicatedCrawlRateRequest.CrawlType אם המצב הוא AUTOMATIC.
EXPLICIT המשתמשים מגדירים במפורש את קצב הסריקה שמופעל על ידי המשתמש או את קצב הרענון האוטומטי.