Method: projects.locations.obtainCrawlRate

Obtém os dados de séries cronológicas da taxa de rastreio orgânica ou dedicada para monitorização. Quando a taxa de rastreio dedicada não está definida, devolve a série cronológica da taxa de rastreio orgânico da Vertex AI. O rastreio orgânico significa que o Google rastreia automaticamente a Internet quando lhe convém. Quando a taxa de rastreio dedicada está definida, devolve a série cronológica da taxa de rastreio dedicada da Vertex AI.

Pedido HTTP

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

O URL usa a sintaxe de transcodificação de gRPC.

Parâmetros de caminho

Parâmetros
location

string

Obrigatório. O recurso de localização onde a gestão da taxa de rastreio vai ser realizada. Formato: projects/{project}/locations/{location}

Corpo do pedido

O corpo do pedido contém dados com a seguinte estrutura:

Representação JSON 
{
  "crawlRateScope": string
}
Campos
crawlRateScope

string

Obrigatório. O âmbito da taxa de rastreio que o utilizador quer monitorizar. Atualmente, apenas são suportados o domínio e o nome do anfitrião. Um exemplo de nome de domínio: example.com. Um exemplo de nome do anfitrião: www.example.com. Não inclua / no domínio nem no nome do anfitrião.

Corpo da resposta

Mensagem de resposta para o método CrawlRateManagementService.ObtainCrawlRate. A resposta contém dados de séries cronológicas da taxa de rastreio orgânica ou dedicada para monitorização, consoante a taxa de rastreio dedicada esteja definida.

Se for bem-sucedido, o corpo da resposta contém dados com a seguinte estrutura:

Representação 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)

Apenas saída. O estado da resposta.
error

object (Status)

Erros do serviço ao processar o pedido.
Campo de união crawl_rate_time_series. Assim que o utilizador define a taxa de rastreio dedicada, esta devolve a série cronológica da taxa de rastreio dedicada. Caso contrário, devolve a série cronológica da taxa de rastreio orgânica. crawl_rate_time_series só pode ser uma das seguintes opções:
organicCrawlRateTimeSeries

object (OrganicCrawlRateTimeSeries)

Os dados de séries cronológicas da taxa de rastreio orgânico do histórico, usados para monitorização.
dedicatedCrawlRateTimeSeries

object (DedicatedCrawlRateTimeSeries)

Os dados de séries cronológicas da taxa de rastreio dedicada histórica, usados para monitorização.

Âmbitos de autorização

Requer um dos seguintes âmbitos do OAuth:

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

Para mais informações, consulte o Authentication Overview.

OrganicCrawlRateTimeSeries

Os dados de séries cronológicas da taxa de rastreio orgânico do histórico, usados para monitorização. A indexação orgânica é determinada automaticamente pelo Google para indexar o Website do utilizador quando a indexação dedicada não está definida. A taxa de rastreio é o QPS do pedido de rastreio que a Google envia para o Website do utilizador.

Representação JSON 
{
  "googleOrganicCrawlRate": {
    object (CrawlRateTimeSeries)
  },
  "vertexAiOrganicCrawlRate": {
    object (CrawlRateTimeSeries)
  }
}
Campos
googleOrganicCrawlRate

object (CrawlRateTimeSeries)

Série cronológica da taxa de rastreio orgânico do Google, que é a soma da taxa de rastreio de todos os googlebots. Consulte https://developers.google.com/search/docs/crawling-indexing/overview-google-crawlers para ver mais detalhes sobre os googlebots.
vertexAiOrganicCrawlRate

object (CrawlRateTimeSeries)

A série cronológica da taxa de rastreio orgânico da Vertex AI, que é a taxa de rastreio do Google-CloudVertexBot quando o rastreio dedicado não está definido. Consulte https://developers.google.com/search/docs/crawling-indexing/google-common-crawlers#google-cloudvertexbot para ver mais detalhes sobre o Google-CloudVertexBot.

CrawlRateTimeSeries

Os dados cronológicos da taxa de rastreio, usados para monitorização.

Representação JSON 
{
  "qpsTimeSeries": {
    object (TimeSeries)
  }
}
Campos
qpsTimeSeries

object (TimeSeries)

O CPS da taxa de rastreio.

DedicatedCrawlRateTimeSeries

Os dados de séries cronológicas da taxa de rastreio dedicada histórica, usados para monitorização. O rastreio dedicado é usado pelo Vertex AI para rastrear o Website do utilizador quando o rastreio dedicado está definido.

Representação JSON 
{
  "userTriggeredCrawlRate": {
    object (CrawlRateTimeSeries)
  },
  "autoRefreshCrawlRate": {
    object (CrawlRateTimeSeries)
  },
  "userTriggeredCrawlErrorRate": {
    object (CrawlRateTimeSeries)
  },
  "autoRefreshCrawlErrorRate": {
    object (CrawlRateTimeSeries)
  }
}
Campos
userTriggeredCrawlRate

object (CrawlRateTimeSeries)

A série cronológica da taxa de rastreio dedicada da Vertex AI de rastreio acionado pelo utilizador, que é a taxa de rastreio do Google-CloudVertexBot quando o rastreio dedicado está definido, e a taxa de rastreio acionado pelo utilizador destina-se a exemplos de utilização determinísticos, como o rastreio de URLs ou mapas do site especificados pelos utilizadores.
autoRefreshCrawlRate

object (CrawlRateTimeSeries)

A série cronológica da taxa de rastreio dedicada da Vertex AI de atualização automática, que é a taxa de rastreio do Google-CloudVertexBot quando o rastreio dedicado está definido, e a taxa de rastreio destina-se a exemplos de utilização de melhor esforço, como a atualização periódica de URLs.
userTriggeredCrawlErrorRate

object (CrawlRateTimeSeries)

Série cronológica da taxa de erros da Vertex AI de uma análise detalhada dedicada acionada pelo utilizador.
autoRefreshCrawlErrorRate

object (CrawlRateTimeSeries)

Série cronológica da taxa de erro do Vertex AI da atualização automática da recolha dedicada.

Estado

Diferentes estados da resposta.

Enumerações
STATE_UNSPECIFIED O estado não está especificado.
SUCCEEDED O estado é bem-sucedido.
FAILED O estado é falhado.