Sobre o controle remoto para indexação

Sempre que seu site mudar, você poderá executar um script ou programa solicitando que o robô de pesquisa execute um índice usando o Controle Remoto.

Usando o controle remoto para indexação

A solicitação de indexação do controle remoto geralmente vem de um script ou programa localizado em seu servidor.

O robô executa as mesmas etapas de indexação que se ele tivesse sido iniciado manualmente no menu Index. Para enviar uma solicitação de controle remoto, configure a senha e as cadeias de caracteres de resposta necessárias.

Como fazer uma solicitação de controle remoto

Para fazer uma solicitação de controle remoto, use os seguintes exemplos de formato com base na localização do seu data center:

ou

A pesquisa retorna dados no formato de uma resposta HTTP adequada. A resposta completa é composta de um status HTTP, cabeçalhos de resposta HTTP, uma linha em branco e a string de resposta.

Por exemplo, suponha que você execute a seguinte solicitação de controle remoto:

https://center.atomz.com/search/cgiindex.tk?sp_a=sp99999999&sp_password=my-password&sp_operation=full_index

Esta é a resposta do servidor:

Status: 200 OK 
Content-type: text/plain 
OK

Ou suponha que você execute a seguinte solicitação de status de controle remoto:

https://center.atomz.com/search/cgiindex.tk?sp_a=sp99999999&sp_password=my-password&sp_operation=full_index_status

A resposta do servidor pode ser semelhante ao seguinte:

Status: 200 OK 
Content-type: application/json; charset=utf-8 
{ 
    "current_time": "2017-08-27T10:58:58-0700", 
    "start_time": "2017-07-25T16:40:07-0800", 
    "end_time": "2017-07-25T16:40:20-0800", 
    "elapsed_seconds": 13, 
    "elapsed_seconds_fmt": "13s", 
    "state": "finished", 
    "docs_indexed": 3, 
    "depth": 0, 
    "errors": 0, 
    "status": 1, 
    "message": "ok" 
}

Para obter as primeiras dez linhas da lista de log associadas a esta operação de índice, juntamente com seu status, a seguinte query é usada:

https://center.atomz.com/search/cgiindex.tk?sp_a=sp99999999&sp_password=my-password&sp_operation=full_index_status&sp_lines=10

A resposta do servidor:

Status: 200 OK 
Content-type: application/json; charset=utf-8 
{ 
    "current_time": "2017-08-27T10:59:30-0700", 
    "start_time": "2017-07-25T16:40:07-0800", 
    "end_time": "2017-07-25T16:40:20-0800", 
    "elapsed_seconds": 13, 
    "elapsed_seconds_fmt": "13s", 
    "state": "finished", 
    "docs_indexed": 3, 
    "depth": 0, 
    "errors": 0, 
    "offset": 672, 
    "lines": [ 
        "07/25 16:40:07 PST   ======== Starting manual crawl of account sp99999999. ========", 
        "07/25 16:40:08 PST   Loading existing data", 
        "07/25 16:40:08 PST   Downloading entrypoint https://www.atomz.com/", 
        "07/25 16:40:08 PST   Robots.txt exclude mask: https://www.atomz.com/snap", 
        "07/25 16:40:08 PST   Exclude mask: regexp ^https://www.atomz.com/$", 
        "07/25 16:40:08 PST   Include mask: https://www.atomz.com/", 
        "07/25 16:40:08 PST   Downloading https://www.atomz.com/style.css", 
        "07/25 16:40:09 PST   Ignoring https://www.atomz.com/style.css, document type 'text/css'.", 
        "07/25 16:40:09 PST   Downloading https://www.atomz.com/privacy.html", 
        "07/25 16:40:09 PST   Downloading https://www.atomz.com/terms.html" 
    ], 
    "status": 1, 
    "message": "ok" 
}

Observe o valor offset. Esse valor identifica a posição de deslocamento de arquivo no arquivo de log, onde a leitura ficou desligada. Para ler as próximas dez linhas no arquivo, você incluiria, neste exemplo, &sp_offset=672 na solicitação enviada ao servidor.

Usando sp_offset, você pode efetivamente passar a página por um arquivo de log.

Para obter as last dez linhas do log, juntamente com o status, especifique a contagem como um número negativo. Por exemplo, especifique sp_lines= com um valor de -10 como no seguinte:

https://center.atomz.com/search/cgiindex.tk?sp_a=sp99999999&sp_password=my-password&sp_operation=full_index_status&sp_lines=-10

A resposta do servidor:

Status: 200 OK 
Content-type: application/json; charset=utf-8 
{ 
    "current_time": "2017-08-27T11:01:14-0700", 
    "start_time": "2017-07-25T16:40:07-0800", 
    "end_time": "2017-07-25T16:40:20-0800", 
    "elapsed_seconds": 13, 
    "elapsed_seconds_fmt": "13s", 
    "state": "finished", 
    "docs_indexed": 3, 
    "depth": 0, 
    "errors": 0, 
    "lines": [ 
        "07/25 16:40:20 PST   End Time: 07/25/2017 16:40:20 PST", 
        "07/25 16:40:20 PST   Elapsed Time: 13 seconds", 
        "07/25 16:40:20 PST   Pages Crawled: 3 pages", 
        "07/25 16:40:20 PST   Pages Indexed: 3 pages", 
        "07/25 16:40:20 PST   Words/Bytes Indexed: 2373 words/ 20618 bytes", 
        "07/25 16:40:20 PST   Errors: 0", 
        "07/25 16:40:20 PST   *** Index Summary ***", 
        "07/25 16:40:20 PST   Total Pages: 3", 
        "07/25 16:40:20 PST   --------------------------------------------------------------------", 
        "07/25 16:40:20 PST   ======== Finish manual crawl of account sp99999999: Done. ========" 
    ], 
    "status": 1, 
    "message": "ok" 
}

Observe que não há valor offset retornado aqui, pois essa operação terminou no final do arquivo e não há mais linhas para ler.

Configurar o controle remoto para indexação

Sempre que seu site mudar, você pode usar o Controle remoto para executar um script ou programa do seu servidor, solicitando que o robô de pesquisa execute um índice.

Configurar o Controle Remoto para indexação

1. No menu do produto, clique em Index > Remote Control.

2. Na página Remote Control , defina cada opção de campo de configuração para poder enviar uma solicitação de indexação do seu servidor automaticamente para indexar seu site.

   Opção	Descrição
   Senha de Controle Remoto	Especifique a senha do controle remoto. As senhas diferenciam maiúsculas de minúsculas, têm pelo menos seis caracteres e devem incluir pelo menos uma letra. É recomendável incluir pelo menos um número. Não use sua senha de logon de pesquisa/comercialização do site. Sua senha é usada em cada solicitação de controle remoto.
   Sequência de Resposta OK	Permite que você especifique uma sequência de texto de resposta OK se a operação de índice solicitada começar com êxito. Nesses casos, o robô de pesquisa retorna a string de resposta OK ao servidor.
   String de resposta prioritária	Se outra operação de indexação estiver em andamento quando a solicitação remota for feita, o robô de pesquisa não poderá executar o índice solicitado. Nesses casos, a sequência de texto da resposta de Prioridade é retornada ao servidor.
   String de resposta do erro	Permite especificar uma sequência de texto de resposta do erro Se a senha estiver incorreta ou se ocorrer outro erro. Nesses casos, o robô de pesquisa retorna a string de resposta do Erro ao servidor.

3. Clique em Save Changes.