關於為索引進行遠程控制

每當您的網站變更時,您都可以執行指令碼或程式,要求搜尋自動機使用遠端控制來執行索引。

使用遠程控制項編製索引

遙控索引請求通常來自伺服器上的指令碼或程式。

自動機執行的索引步驟與從菜單手動啟動的步驟相 Index 同。 要提交遠程控制請求,請配置必要的密碼和響應字串。

如何提出遠程控制請求

要發出遠程控制請求,請根據資料中心的位置使用以下格式示例:

資料中心位置

範例

倫敦

https://center.lon5.atomz.com/search/cgiindex.tk? sp_a=sp99999999&sp_password=xxxxxx&sp_operation=op

北美

https://center.atomz.com/search/cgiindex.tk? sp_a=sp99999999&sp_password=xxxxxx&sp_operation=op

新加坡

https://center.sin2.atomz.com/search/cgiindex.tk? sp_a=sp99999999&sp_password=xxxxxx&sp_operation=op

字串與值

說明

sp_a= sp99999999

您的帳號。

您可以在「帳戶設定」 >「帳戶選 項」>「帳戶 設定」 >「帳戶設定 」下找到 您的編號。

sp_lines= N

可讓您檢查正在運行的索引編目的狀態。

N 是正整數或全 。 如果這是數值,則對應索引記錄 的最後N行會包含在JSON回應中。

如果值全部 ,則會傳回整個檔案。

如果值為 0 ,則不會傳回記錄資訊。 此值是運行索引狀態查詢的預設值。

sp_operation= op

可讓您指定下列其中一個要執行的索引作業:

  • full_index

    搜尋機器人會執行您網站的完整索引。

  • 增量索引

    使用配置的搜索增量索引使用配置設定在 Index > Incremental Index >Index下的搜索增量索引運行配置Configuration Contribution Robot。

  • 垂直索引

    使用配置的搜索垂直更新在「Index > Vertical Update > Configuration」( Index Vertical Update > Configuration)下設定。

    請參閱 關於垂直更新

  • script_index

    搜索自動機使用在「索引 >指令碼化索引 > Scripted Index >指令碼化索引」(Scripted Index > Configuration)下指定的文本檔案運行 的增量索引。

  • full_staged_index

    搜尋自動機會執行您網站的完整分段索引。

  • incremental_staged_index

    搜索增量分段索引使用在「索引 >增量索引」( Index > Incremental Index)下設定的配置來運行 Configuration Index Robot(搜索增量分段索引)。

  • 垂直_staged_index

    搜索自動機使用在「Index > Vertical Update > Regintal Update > Configuration」(垂直更新> Index Update)下設定的配置,運行垂直分段更新。

注意: 若要使用「垂直更新」,您可能需要由Adobe帳戶代表或Adobe支援在您的帳戶中啟用它。

請參閱 關於垂直更新

您可以將 _saved附加 到上述任何sp_operation值,使搜索自動機 嘗試使用已保存的內容。 例如,您可以指定下列項目:

sp_operation=full_index_saved

sp_operation=full_staged_index_saved

或者,您可以將 _status附加至上述任何 sp_operation值,以請求目前或最近一次操作的狀態報告。 例如,您可以指定下列項目:

sp_operation=full_index_status

sp_operation=full_staged_index_status

結果會以JSON物件傳回。 包 含sp_lines=N 以包含N行相關日誌檔案。 如果N為負數,則會包含最後N行。

sp_operation= pushlive

可讓您遠端推送即時分段索引。

任何將_saved附 加至推 送即時作業的嘗試都會被忽略。

當您執行Pushlive 作時,會將OK、Priority或Error回應文字字串傳回伺服器。 您可在「遠程控制」頁面上指 定這些響 應字串。

請參 閱配置遠程控制以編製索引

如果您在沒有分段索引時推送為即時,則不會發生任何動作,並傳回「確定」回應字串。

sp_password= xxxxxx

遙控密碼。

搜尋會以適當HTTP回應的形式傳回資料。 完整回應由HTTP狀態、HTTP回應標題、空白行和回應字串組成。

例如,假設您執行以下遠程控制請求:

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

以下是來自伺服器的響應:

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

或者,假設您執行下列遠程控制狀態請求:

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

來自伺服器的回應可能如下所示:

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" 
}

要獲取與此索引操作關聯的日誌清單的前10行及其狀態,請使用以下查詢:

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

來自伺服器的響應:

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" 
}

Note the offset value. 此值標識日誌檔案中的檔案偏移位置,其中讀取為左。 若要讀取 檔案中 的後10行 &sp_offset=672 ,請在此範例中,在傳送至伺服器的請求中加入。

使用 sp_offset時,您可以有效地透過記錄檔進行頁面設定。

若要取得 記錄 的最後10行以及狀態,請將計數指定為負數。 例如,指定 sp_lines= 的值為 -10 ,如下所示:

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

來自伺服器的響應:

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" 
}

請注意,此處 offset 沒有返回值,因為此操作在檔案末尾完成,並且沒有其他行可供讀取。

配置遠程控制以編製索引

每當您的網站變更時,您都可以使用「遠端控制」從伺服器執行指令碼或程式,要求搜尋自動機執行索引。

配置遠程控制以編製索引

  1. 在產品功能表上,按一下 Index > Remote Control

  2. 在頁面 Remote Control 上,設定每個設定欄位選項,以便能夠自動從伺服器提交索引請求,為您的網站建立索引。

    選項

    說明

    遠程控制密碼

    指定遠程控制密碼。

    密碼區分大小寫,至少有6個字元長,且必須至少包含一個字母。 建議您也至少包含一個數字。

    請勿使用您的網站搜尋/銷售登入密碼。

    每個遠程控制請求都會使用您的密碼。

    確定響應字串

    可讓您在請求的索引操作成功開始時指定「確定」響應文本字串。 在這種情況下,搜索自動機將您的「確定」(OK)響應字串返回到伺服器。

    優先順序回應字串

    如果在執行遠程請求時正在執行另一個索引操作,則搜索自動機無法執行請求的索引。 在這種情況下,您的優先順序回應文字字串會傳回至伺服器。

    錯誤回應字串

    可讓您指定「錯誤」回應文字字串。如果您的密碼不正確,或是發生其他錯誤。 在這種情況下,搜索自動機會將錯誤響應字串返回伺服器。

  3. 按一下 Save Changes.

本頁內容