Method: projects.locations.obtainCrawlRate

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

בקשת HTTP

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

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

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

פרמטרים
location

string

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

גוף הבקשה

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

ייצוג JSON 
{
  "crawlRateScope": string
}
שדות
crawlRateScope

string

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

גוף התשובה

הודעת תגובה לשיטה CrawlRateManagementService.ObtainCrawlRate. התשובה מכילה נתונים של סדרת זמנים של קצב סריקה אורגני או ייעודי לצורך מעקב, בהתאם להגדרה של קצב סריקה ייעודי.

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

ייצוג 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.
}
שדות
state

enum (State)

פלט בלבד. המצב של התשובה.
error

object (Status)

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

object (OrganicCrawlRateTimeSeries)

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

object (DedicatedCrawlRateTimeSeries)

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

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של 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.

OrganicCrawlRateTimeSeries

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

ייצוג JSON 
{
  "googleOrganicCrawlRate": {
    object (CrawlRateTimeSeries)
  },
  "vertexAiOrganicCrawlRate": {
    object (CrawlRateTimeSeries)
  }
}
שדות
googleOrganicCrawlRate

object (CrawlRateTimeSeries)

סדרת הזמן של קצב הסריקה האורגני של Google, שהיא סכום קצב הסריקה של כל ה-Googlebot. פרטים נוספים על Googlebot זמינים בכתובת https://developers.google.com/search/docs/crawling-indexing/overview-google-crawlers.
vertexAiOrganicCrawlRate

object (CrawlRateTimeSeries)

סדרת הזמן של קצב הסריקה האורגני של Vertex AI, שהוא קצב הסריקה של Google-CloudVertexBot כשלא מוגדרת סריקה ייעודית. פרטים נוספים על Google-CloudVertexBot זמינים בכתובת https://developers.google.com/search/docs/crawling-indexing/google-common-crawlers#google-cloudvertexbot.

CrawlRateTimeSeries

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

ייצוג JSON 
{
  "qpsTimeSeries": {
    object (TimeSeries)
  }
}
שדות
qpsTimeSeries

object (TimeSeries)

ה-QPS של קצב הסריקה.

DedicatedCrawlRateTimeSeries

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

ייצוג JSON 
{
  "userTriggeredCrawlRate": {
    object (CrawlRateTimeSeries)
  },
  "autoRefreshCrawlRate": {
    object (CrawlRateTimeSeries)
  },
  "userTriggeredCrawlErrorRate": {
    object (CrawlRateTimeSeries)
  },
  "autoRefreshCrawlErrorRate": {
    object (CrawlRateTimeSeries)
  }
}
שדות
userTriggeredCrawlRate

object (CrawlRateTimeSeries)

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

object (CrawlRateTimeSeries)

סדרת הזמן של קצב הסריקה הייעודי של Vertex AI של רענון אוטומטי, שהוא קצב הסריקה של Google-CloudVertexBot כשמוגדרת סריקה ייעודית, וקצב הסריקה מיועד לתרחישי שימוש של מאמץ מרבי כמו רענון כתובות URL באופן תקופתי.
userTriggeredCrawlErrorRate

object (CrawlRateTimeSeries)

סדרת הזמן של שיעור השגיאות ב-Vertex AI של סריקה ייעודית שהופעלה על ידי משתמש.
autoRefreshCrawlErrorRate

object (CrawlRateTimeSeries)

סדרת הזמנים של שיעור השגיאות ב-Vertex AI של סריקה ייעודית עם רענון אוטומטי.

מדינה

מצבים שונים של התשובה.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED המצב לא צוין.
SUCCEEDED הסטטוס הוא 'הושלם בהצלחה'.
FAILED המצב הוא 'נכשל'.