インデックス作成のリモートコントロールについて

Webサイトが変更された場合は常に、リモートコントロールを使用して検索ロボットにインデックスの実行を要求するスクリプトまたはプログラムを実行できます。

リモートコントロールを使用したインデックス作成

リモートコントロールのインデックス作成要求は、通常、サーバー上にあるスクリプトまたはプログラムから発生します。

ロボットは、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

実行するインデックス作成操作を次の中から1つ指定できます。

  • full_index

    検索ロボットはウェブサイトの完全なインデックスを実行します。

  • incremental_index

    検索ロボットは、 インデックス 増分インデックス 設定に設定された構成を使用して増分インデックスを実行します。

  • vertical_index

    検索ロボットは、 インデックス > 垂直更新 > 設定に設定された設定を使用して垂直更新を実行します。

    垂直更新についてを参照してください。

  • script_index

    検索ロボットは、 インデックス スクリプトインデックス 設定で指定されたテキストファイルを使用してインクリメンタルインデックスを実行します。

  • full_staged_index

    検索ロボットは、ウェブサイトの完全なステージインデックスを実行します。

  • incremental_staged_index

    検索ロボットは、 インデックス 増分インデックス 設定に設定された構成を使用して、増分ステージインデックスを実行します。

  • vertical_staged_index

    検索ロボットは、 インデックス 垂直更新 設定の下に設定された設定を使用して、垂直段階更新を実行します。

注意: 垂直アップデートを使用するには、Adobeのアカウント担当者またはAdobeサポートがアカウントで有効にする必要がある場合があります。

縦置き版の更新についてを参照してください。

上記の sp_operation 値のいずれかに _saved を追加すると、検索ロボットが保存したコンテンツを使用しようとします。 例えば、次のように指定できます。

sp_operation=full_index_saved

または

sp_operation=full_staged_index_saved

または、上記の sp_operation 値のいずれかに _status を追加して、現在または最新の操作に関するステータスレポートを要求できます。 例えば、次のように指定できます。

sp_operation=full_index_status

または

sp_operation=full_staged_index_status

結果はJSONオブジェクトとして返されます。 sp_lines=N を含めて、関連するログファイルのN行を含めます。 Nが負の値の場合は、最後のN行が含まれます。

sp_operation= pushlive

ステージングされたインデックスをリモートでプッシュして有効にできます。

プッシュライブ操作に _saved を追加しようとしても無視されます。

pushlive 操作を実行すると、OK、優先度、またはエラーの応答テキスト文字列がサーバーに返されます。 これらの応答文字列は、リモートコントロールページで指定します。

リモートコントロールのインデックス作成の構成」を参照してください。

ステージングされたインデックスがない場合にライブをプッシュすると、何も起こらず、OK応答文字列が返されます。

sp_password= xxxxx

リモコンパスワードです。

検索は、適切な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" 
}

offsetの値をメモしておきます。 この値は、読み取りが行われたログファイル内のファイルオフセットの位置を示します。 ファイル内の​next 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値が返されません。

のインデックス作成のためのリモートコントロールの構成

Webサイトが変更された場合は常に、リモートコントロールを使用して、検索ロボットにインデックスの実行を要求して、サーバーからスクリプトまたはプログラムを実行できます。

インデックス作成用のリモートコントロールを構成するには

  1. 製品メニューで、Index/Remote Control​をクリックします。

  2. Remote Controlページで、各設定フィールドのオプションを設定し、自動的にサーバーからインデックス作成要求を送信してWebサイトのインデックスを作成できるようにします。

    オプション

    説明

    リモートコントロールパスワード

    リモートコントロールのパスワードを指定します。

    パスワードは大文字と小文字が区別され、長さが6文字以上で、1文字以上にする必要があります。 少なくとも1つの数字も含めることをお勧めします。

    サイト検索/マーチャンダイジングのログインパスワードは使用しないでください。

    パスワードは、各リモートコントロール要求で使用されます。

    OK応答文字列

    要求されたインデックス操作が正常に開始した場合に、OK応答のテキスト文字列を指定できます。 この場合、検索ロボットはOK応答文字列をサーバに返します。

    優先度応答文字列

    リモート要求が行われた際に、別のインデックス作成操作が進行中の場合、検索ロボットは要求されたインデックスを実行できません。 このような場合、Priority応答テキスト文字列がサーバーに返されます。

    エラー応答文字列

    エラー応答のテキスト文字列を指定できます。パスワードが正しくない場合や、別のエラーが発生した場合。 このような場合、検索ロボットはエラー応答文字列をサーバに返します。

  3. クリック Save Changes.

このページ