Method: projects.locations.obtainCrawlRate

Obtiene los datos de series temporales de la frecuencia de rastreo orgánica o dedicada para la supervisión. Cuando no se establece la frecuencia de rastreo dedicada, se mostrará la serie temporal de la frecuencia de rastreo orgánica de Vertex AI. El rastreo orgánico significa que Google rastrea automáticamente Internet cuando le resulta conveniente. Cuando se establece la frecuencia de rastreo dedicada, se mostrará la serie temporal de la frecuencia de rastreo dedicada de Vertex AI.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
location

string

Obligatorio. El recurso de ubicación en el que se realizará la administración de la frecuencia de rastreo. Formato: projects/{project}/locations/{location}

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "crawlRateScope": string
}
Campos
crawlRateScope

string

Obligatorio. El alcance de la frecuencia de rastreo que el usuario desea supervisar. Actualmente, solo se admiten el dominio y el nombre de host. Ejemplo de nombre de dominio: example.com. Ejemplo de nombre de host: www.example.com. No incluyas / en el dominio ni en el nombre de host.

Cuerpo de la respuesta

Mensaje de respuesta para el método CrawlRateManagementService.ObtainCrawlRate. La respuesta contiene datos de series temporales de la frecuencia de rastreo orgánica o dedicada para la supervisión, según si se establece la frecuencia de rastreo dedicada.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación 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.
}
Campos
state

enum (State)

Solo salida. El estado de la respuesta.
error

object (Status)

Errores del servicio cuando se controla la solicitud.
Campo de unión crawl_rate_time_series. Una vez que el usuario establece la frecuencia de rastreo dedicada, se mostrará la serie temporal de la frecuencia de rastreo dedicada. De lo contrario, se mostrará la serie temporal de la frecuencia de rastreo orgánica. crawl_rate_time_series puede ser solo uno de los parámetros siguientes:
organicCrawlRateTimeSeries

object (OrganicCrawlRateTimeSeries)

Los datos históricos de series temporales de la frecuencia de rastreo orgánica, que se usan para la supervisión.
dedicatedCrawlRateTimeSeries

object (DedicatedCrawlRateTimeSeries)

Los datos históricos de series temporales de la frecuencia de rastreo dedicada, que se usan para la supervisión.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

Para obtener más información, consulta Authentication Overview.

OrganicCrawlRateTimeSeries

Los datos históricos de series temporales de la frecuencia de rastreo orgánica, que se usan para la supervisión. Google determina automáticamente el rastreo orgánico para rastrear el sitio web del usuario cuando no se establece el rastreo dedicado. La frecuencia de rastreo es la QPS de la solicitud de rastreo que Google envía al sitio web del usuario.

Representación JSON 
{
  "googleOrganicCrawlRate": {
    object (CrawlRateTimeSeries)
  },
  "vertexAiOrganicCrawlRate": {
    object (CrawlRateTimeSeries)
  }
}
Campos
googleOrganicCrawlRate

object (CrawlRateTimeSeries)

La serie temporal de la frecuencia de rastreo orgánica de Google, que es la suma de la frecuencia de rastreo de todos los Googlebots. Consulta https://developers.google.com/search/docs/crawling-indexing/overview-google-crawlers para obtener más detalles sobre los googlebots.
vertexAiOrganicCrawlRate

object (CrawlRateTimeSeries)

La serie temporal de la frecuencia de rastreo orgánica de Vertex AI, que es la frecuencia de rastreo de Google-CloudVertexBot cuando no se establece el rastreo dedicado. Consulta https://developers.google.com/search/docs/crawling-indexing/google-common-crawlers#google-cloudvertexbot para obtener más detalles sobre Google-CloudVertexBot.

CrawlRateTimeSeries

Los datos históricos de series temporales de la frecuencia de rastreo, que se usan para la supervisión.

Representación JSON 
{
  "qpsTimeSeries": {
    object (TimeSeries)
  }
}
Campos
qpsTimeSeries

object (TimeSeries)

La QPS de la frecuencia de rastreo.

DedicatedCrawlRateTimeSeries

Los datos históricos de series temporales de la frecuencia de rastreo dedicada, que se usan para la supervisión. Vertex AI usa el rastreo dedicado para rastrear el sitio web del usuario cuando se establece el rastreo dedicado.

Representación JSON 
{
  "userTriggeredCrawlRate": {
    object (CrawlRateTimeSeries)
  },
  "autoRefreshCrawlRate": {
    object (CrawlRateTimeSeries)
  },
  "userTriggeredCrawlErrorRate": {
    object (CrawlRateTimeSeries)
  },
  "autoRefreshCrawlErrorRate": {
    object (CrawlRateTimeSeries)
  }
}
Campos
userTriggeredCrawlRate

object (CrawlRateTimeSeries)

La serie temporal de la frecuencia de rastreo dedicada de Vertex AI del rastreo activado por el usuario, que es la frecuencia de rastreo de Google-CloudVertexBot cuando se establece el rastreo dedicado, y la frecuencia de rastreo activada por el usuario es para casos de uso deterministas, como rastrear URLs o mapas del sitio especificados por los usuarios.
autoRefreshCrawlRate

object (CrawlRateTimeSeries)

La serie temporal de la frecuencia de rastreo dedicada de Vertex AI de la actualización automática, que es la frecuencia de rastreo de Google-CloudVertexBot cuando se establece el rastreo dedicado, y la frecuencia de rastreo es para casos de uso de mejor esfuerzo, como actualizar URLs de forma periódica.
userTriggeredCrawlErrorRate

object (CrawlRateTimeSeries)

La serie temporal de la tasa de error de Vertex AI del rastreo dedicado activado por el usuario.
autoRefreshCrawlErrorRate

object (CrawlRateTimeSeries)

La serie temporal de la tasa de error de Vertex AI del rastreo dedicado de actualización automática.

Estado

Diferentes estados de la respuesta.

Enums
STATE_UNSPECIFIED El estado no se especifica.
SUCCEEDED El estado es correcto.
FAILED El estado es fallido.