Show Menu
トピック×

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

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応答に含まれます。
値がallの場合、フ ァイ ル全体が返されます。
値が0の場合、ロ グ情 報は返されません。 この値は、実行中のインデックスステータスクエリのデフォルト値です。
sp_operation= op
実行するインデックス作成操作を次の中から1つ指定できます。
  • full_index
    検索ロボットは、ウェブサイトの完全なインデックスを実行します。
  • incremental_index
    検索ロボットは、Index > Incremental Incremental Incremental Index > Configuration Configuration Indexの下に設定された設定を使用して、インクリメンタルインデックスを実行する。
  • vertical_index
    検索ロボットは、 Index > Vertical > Vertical Update Configuration Configurationの下に設定された設定を用いて更新を実行する。
  • script_index
    検索ロボットは、Index > Scripted Index > Configuration Configuration Scripted Index > Scripted Index > Configuration Configurationで指定されたテキストファイルを使用して、増分インデックスを実行します。
  • full_staged_index
    検索ロボットは、ウェブサイトの完全なステージインデックスを実行します。
  • incremental_staged_index
    検索ロボットは、Index > Incremental Index > Incremental Index > Configuration Configuration Configuration Indexの下に設定された設定を使用して、増分ステージングインデックスを実行します。
  • vertical_staged_index
    検索ロボットは、Index > Vertical Update Update Update Vertical Update Configuration Configuration Stagedの下に設定された設定を使用して、垂直段階更新を実行します。
注意: 業務別アップデートを使用するには、お使いのアカウントで、アドビのアカウント担当者またはアドビサポートによって有効にされる必要がある場合があります。
垂直更新につ いてを参照してくだ さい。
上記の 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
ステージングされたインデックスをリモートでプッシュできます。
「Push Live」操作に_saved を追加しようとしても無視されます。
pushlive操作を実行する と、OK、 優先度、またはエラーの応答テキスト文字列がサーバーに返されます。 これらの応答文字列は、[リモートコントロール]ペ ージで指定 します。
ステージングされたインデックスがないときにライブをプッシュした場合、何も起こらず、OK応答文字列が返されます。
sp_password=xxxx
リモートコントロールのパスワード。
検索は、適切な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 後で終了し、読み込む行がなくなったので、ここに値が返されません。

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

Webサイトが変更された場合は、リモートコントロールを使用して、検索ロボットにインデックスの実行を要求するスクリプトまたはプログラムをサーバーから実行できます。
インデックス作成用のリモートコントロールを構成するには
  1. 製品メニューで、/をクリッ Index クしま Remote Control ​す。
  2. ページで、 Remote Control 各設定フィールドのオプションを設定し、Webサイトのインデックスを作成するインデックス作成要求をサーバーから自動的に送信できるようにします。
    オプション
    説明
    リモートコントロールパスワード
    リモートコントロールのパスワードを指定します。
    パスワードは大文字と小文字が区別され、長さが6文字以上で、少なくとも1文字を含める必要があります。 少なくとも1つの数字も含めることをお勧めします。
    サイト検索/マーチャンダイジングのログインパスワードは使用しないでください。
    パスワードは、各リモートコントロール要求で使用されます。
    OK応答文字列
    要求されたインデックス操作が正常に開始した場合に、OK応答のテキスト文字列を指定できます。 この場合、検索ロボットはOK応答文字列をサーバに返します。
    優先度応答文字列
    リモート要求が行われたときに別のインデックス作成操作が進行中の場合、検索ロボットは要求されたインデックスを実行できません。 このような場合、Priority応答のテキスト文字列がサーバーに返されます。
    エラー応答文字列
    エラー応答のテキスト文字列を指定できます。パスワードが正しくない場合や、別のエラーが発生した場合。 このような場合、検索ロボットはエラー応答文字列をサーバに返します。
  3. クリック Save Changes .