Method: projects.locations.setDedicatedCrawlRate

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

בקשת HTTP


POST https://discoveryengine.googleapis.com/v1beta/{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 יסרוק ב-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
  • https://www.googleapis.com/auth/discoveryengine.serving.readwrite

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

CrawlType

סוג הסריקה משמש להבחנה בין סריקה שהופעלה על ידי משתמש לבין רענון אוטומטי. קצב הסריקה שמופעל על ידי משתמשים מיועד לתרחישי שימוש דטרמיניסטיים, כמו סריקה של כתובות אתרים לסריקה או מפות אתרים שצוינו על ידי משתמשים. קצב הסריקה של רענון אוטומטי מיועד לתרחישי שימוש שבהם נדרש מאמץ מרבי, כמו רענון כתובות 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 אם המצב הוא אוטומטי.
EXPLICIT המשתמשים מגדירים במפורש את קצב הסריקה שמופעל על ידי המשתמש או את קצב הרענון האוטומטי.