インデックス文書を作成する

属性値を渡してドキュメントを作成する方法

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

Ingestion APIを使って、属性値を渡してインデックスドキュメントを作成できます。これは、属性値を渡して素早くコンテンツを追加したい場合に便利で、次のスケジュールされた再クロールを待ちたくない場合に便利です。

!注あるいは、属性値を渡す代わりに、Ingestion APIを使ってURLやファイルから属性抽出ロジックを渡してインデックス文書を作成することもできます。既存のドキュメントエクストラクタを使うか、新しいドキュメントエクストラクタを作成することもできます。

インジェスションAPIを使って属性値を渡して文書を作成するには、POST呼び出しを行ってください。 {base-URL}/ingestion/v1/domains/{domain ID}/sources/{sourceID}/entities/{entityID}/documents?locale={locale}

このメソッドのデータモデルおよびオブジェクトおよびキーの説明については、Ingestion API参照を参照してください。ベースURLはSearchのDeveloper Resourcesセクションで確認できます。

!注インデックスドキュメントを作成する際は、データモデルで必要とマークされたすべての属性をパスしなければなりません。また、Sitecore SearchのAttributesセクションDomain Settings > > Administrationで必須とマークされたすべての属性もパスしなければなりません。

例えば、タイトル、説明、タイプ、URLのフィールドを含むインデックスドキュメントを作成したい場合です。

こちらがPOST CURLのコールのサンプルです:

curl --location 'https:///ingestion/v1/domains//sources//entities//documents?locale=' \ --header 'Content-Type: application/json' \ --header 'Authorization: ' \ --data '{ "document": { "id": "test_id_123", "fields": { "title": "Test blog", "description": "This is an awesome blog", "type": "blog", "url": "www.someURL.com" } } }'

申請が成功した場合、以下の文200回答が届きます:

{ "enqueued": true }

回答では、enqueuedはSearchがこの文書をインデックスキューに追加したことを意味します。インジェスションジョブがインキューに入った後、文書の更新がSearchのContent Collectionセクションに反映されるまでに数分かかることがあります。詳細は「インジェスションタイミング」を参照してください。

この記事を改善するための提案がある場合は、お知らせください!