Method: projects.locations.obtainCrawlRate

Obtiene los datos de la serie temporal de la tasa de rastreo orgánica o dedicada para monitorizarla. Si no se define una frecuencia de rastreo específica, se devolverá la serie temporal de la frecuencia de rastreo orgánica de Vertex AI. El rastreo orgánico significa que Google rastrea Internet automáticamente cuando le conviene. Cuando se establece una frecuencia de rastreo dedicada, se devuelve 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 utiliza la sintaxis de transcodificación a gRPC.

Parámetros de ruta

Parámetros
location

string

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

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos que presentan la siguiente estructura:

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

string

Obligatorio. El ámbito de la tasa de rastreo que quiere monitorizar el usuario. Actualmente, solo se admiten el dominio y el nombre de host. Por ejemplo, example.com. Por ejemplo, www.example.com. No incluyas / en el nombre de dominio o de host.

Cuerpo de la respuesta

Mensaje de respuesta del método CrawlRateManagementService.ObtainCrawlRate. La respuesta contiene datos de series temporales de la frecuencia de rastreo orgánica o dedicada para la monitorización, en función de si se ha definido la frecuencia de rastreo dedicada.

Si la solicitud se realiza correctamente, el cuerpo de la respuesta proporciona 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 de salida. El estado de la respuesta.
error

object (Status)

Errores del servicio al gestionar la solicitud.
Campo de unión crawl_rate_time_series. Una vez que el usuario haya definido la frecuencia de rastreo específica, se devolverá la serie temporal de la frecuencia de rastreo específica. De lo contrario, se devolverá la serie temporal de la frecuencia de rastreo orgánica. crawl_rate_time_series solo puede ser una de estas dos opciones:
organicCrawlRateTimeSeries

object (OrganicCrawlRateTimeSeries)

Los datos de la serie temporal del historial de la tasa de rastreo orgánico, que se usan para la monitorización.
dedicatedCrawlRateTimeSeries

object (DedicatedCrawlRateTimeSeries)

Los datos de la serie temporal del historial de la tasa de rastreo dedicada, que se usan para la monitorización.

Permisos de autorización

Debes disponer de uno de los siguientes permisos de OAuth:

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

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

OrganicCrawlRateTimeSeries

Los datos de la serie temporal del historial de la tasa de rastreo orgánico, que se usan para la monitorización. Google determina automáticamente el rastreo orgánico para rastrear el sitio web del usuario cuando no se ha definido el rastreo dedicado. La tasa de rastreo es el número de consultas por segundo de rastreo que Google envía al sitio web del usuario.

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

object (CrawlRateTimeSeries)

Serie temporal de la frecuencia de rastreo orgánica de Google, que es la suma de la frecuencia de rastreo de todos los robots de Google. Para obtener más información sobre los googlebots, consulta https://developers.google.com/search/docs/crawling-indexing/overview-google-crawlers.
vertexAiOrganicCrawlRate

object (CrawlRateTimeSeries)

Serie temporal de la frecuencia de rastreo orgánica de Vertex AI, que es la frecuencia de rastreo de Google-CloudVertexBot cuando no se ha definido el rastreo dedicado. Para obtener más información sobre Google-CloudVertexBot, consulta https://developers.google.com/search/docs/crawling-indexing/google-common-crawlers#google-cloudvertexbot.

CrawlRateTimeSeries

Los datos de serie temporal del historial de la frecuencia de rastreo, que se usan para la monitorización.

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

object (TimeSeries)

Las consultas por segundo de la frecuencia de rastreo.

DedicatedCrawlRateTimeSeries

Los datos de la serie temporal del historial de la tasa de rastreo dedicada, que se usan para la monitorización. Vertex AI usa el rastreo dedicado para rastrear el sitio web del usuario cuando se configura el rastreo dedicado.

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

object (CrawlRateTimeSeries)

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 define el rastreo dedicado. La frecuencia de rastreo activada por el usuario se usa en casos prácticos deterministas, como rastrear URLs o mapas de sitios especificados por los usuarios.
autoRefreshCrawlRate

object (CrawlRateTimeSeries)

La serie temporal de la frecuencia de rastreo dedicada de Vertex AI, que es la frecuencia de rastreo de Google-CloudVertexBot cuando se define el rastreo dedicado. La frecuencia de rastreo se usa en casos prácticos que requieren el mejor esfuerzo posible, como la actualización periódica de URLs.
userTriggeredCrawlErrorRate

object (CrawlRateTimeSeries)

Serie temporal de la tasa de errores de Vertex AI de rastreo dedicado activado por el usuario.
autoRefreshCrawlErrorRate

object (CrawlRateTimeSeries)

Serie temporal de la tasa de errores de Vertex AI de rastreo dedicado con actualización automática.

Estado

Los diferentes estados de la respuesta.

Enumeraciones
STATE_UNSPECIFIED El estado no está especificado.
SUCCEEDED El estado es correcto.
FAILED El estado es Failed (Fallido).