* @param items the list of suggested items
     */
    public PopularWordsResponse(final String index, final long tookMs, final List<String> words, final long total,
            final List<SuggestItem> items) {
        this.index = index;
        this.tookMs = tookMs;
        this.words = words;
        num = words.size();
        this.total = total;
        this.items = items;
    }

    /**

     * @return a list of suggest items parsed from the query log
     */
    List<SuggestItem> parseQueryLog(QueryLog queryLog, String[] fields, String[] tagFieldNames, String roleFieldName,
            ReadingConverter readingConverter, Normalizer normalizer);

    /**
     * Parses a document and extracts suggest items based on the provided fields and converters.
     *

/**
 * Interface for writing suggest items.
 */
public interface SuggestWriter {
    /**
     * Writes the given suggest items to the specified index.
     *
     * @param client   the client used to interact with the search engine
     * @param settings the settings for the suggest feature
     * @param index    the name of the index where the suggest items will be written

    /** The list of suggested items. */
    protected final List<SuggestItem> items;

    /**
     * Constructor for SuggestResponse.
     * @param index The index name.
     * @param tookMs The time taken in milliseconds.
     * @param words The list of suggested words.
     * @param total The total number of hits.
     * @param items The list of suggested items.
     */

import org.opensearch.transport.client.Client;

/**
 * SuggestBulkFileWriter is an implementation of the SuggestWriter interface.
 * This class is responsible for writing and deleting suggest items in bulk.
 *
 * <p>Currently, the methods in this class throw UnsupportedOperationException
 * as they are not yet implemented.</p>
 *
 * @see SuggestWriter
 */

        QueryLog queryLog = new QueryLog("content:検索エンジン", null);
        List<SuggestItem> items = defaultContentsParser.parseQueryLog(queryLog, supportedFields, tagFieldNames, roleFieldName,
                createDefaultReadingConverter(), createDefaultNormalizer());
        SuggestItem item = items.get(0);
        assertEquals("検索エンジン", item.getText());
        assertEquals(SuggestItem.Kind.QUERY, item.getKinds()[0]);

    @Override
    public SuggestWriterResult write(final Client client, final SuggestSettings settings, final String index, final SuggestItem[] items,
            final boolean update) {
        final BulkRequestBuilder bulkRequestBuilder = client.prepareBulk();

        final SuggestItem[] mergedItems = mergeItems(items);
        if (mergedItems.length == 0) {
            return new SuggestWriterResult();
        }

            words.add(text);

            if (detail) {
                items.add(SuggestItem.parseSource(source));
            }
        }

        return new PopularWordsResponse(index, searchResponse.getTook().getMillis(), words, searchResponse.getHits().getTotalHits().value(),
                items);
    }

    /**
     * The expiration time for the filter cache in seconds.
     */
    protected int filterCacheExpireAfterWrite = 10; // 10sec

    /**
     * The maximum number of items to load into the cache.
     */
    protected int maxLoadSize = 10000;

    /**
     * Creates a new instance of OpenSearchUrlFilterService.
     * @param crawlerConfig The crawler configuration.
     */