Python 2.7 telah mencapai akhir dukungan
dan akan
dihentikan penggunaannya
pada 31 Januari 2026. Setelah penghentian penggunaan, Anda tidak akan dapat men-deploy aplikasi Python 2.7, meskipun organisasi Anda sebelumnya menggunakan kebijakan organisasi untuk mengaktifkan kembali deployment runtime lama. Aplikasi Python 2.7 yang ada akan terus berjalan dan menerima traffic setelah
tanggal penghentiannya. Sebaiknya Anda
bermigrasi ke versi Python terbaru yang didukung.
Class ScoredDocument
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Class ScoredDocument mewakili dokumen yang dinilai yang ditampilkan dari penelusuran. Anda tidak membangun class ini secara eksplisit; namun, class ini ditampilkan sebagai hasil dari Index.search().
ScoredDocument ditentukan dalam modul google.appengine.api.search.
Konstruktor
Konstruktor untuk class MatchScorer ditentukan sebagai berikut:
-
class ScoredDocument(doc_id=None, fields=None, language='en', sort_scores=None, expressions=None, cursor=None, rank=None)
Menunjukkan dokumen yang dinilai yang ditampilkan dari penelusuran.
Argumen
- doc_id
String ASCII yang terlihat dan dapat dicetak yang mengidentifikasi dokumen. Tidak boleh diawali dengan '!'. Spasi kosong dikecualikan dari ID. Jika tidak ada ID yang diberikan, layanan penelusuran akan menyediakannya.
- kolom
Iterable instance Kolom yang mewakili konten dokumen.
- bahasa
Kode bahasa ISO 639.2 dua huruf dari bahasa yang digunakan di nilai kolom.
- sort_scores
Daftar skor yang ditetapkan selama evaluasi pengurutan. Setiap dimensi pengurutan disertakan. Skor positif digunakan untuk pengurutan menaik; skor negatif untuk menurun.
- ekspresi
Daftar kolom komputasi yang merupakan hasil dari ekspresi yang diminta.
- kursor
Kursor yang terkait dengan dokumen.
- peringkat
Peringkat dokumen digunakan untuk menentukan urutan dokumen ini yang akan ditampilkan dalam hasil pencarian, di mana 0 <= peringkat <= sys.maxint. Jika tidak ditentukan, jumlah detik sejak 1 Januari 2011 akan digunakan. Dokumen ditampilkan dalam urutan menurun sesuai ID pesanan.
Nilai hasil
Instance baru dari class ScoredDocument.
Pengecualian
- TypeError
Jika salah satu parameter memiliki jenis yang tidak valid, atau atribut yang tidak diketahui diteruskan.
- ValueError
Apakah ada parameter yang memiliki nilai yang tidak valid.
Properti
Instance class ScoredDocument memiliki properti berikut:
- sort_scores
Menampilkan daftar skor yang ditetapkan saat API mengurutkan hasil penelusuran. Setiap dimensi pengurutan disertakan. Skor positif digunakan untuk pengurutan menaik dan skor negatif untuk menurun.
- ekspresi
Daftar kolom komputasi hasil evaluasi ekspresi. Misalnya, ekspresi kolom berikut mencoba menghitung kolom cuplikan yang berisi cuplikan HTML yang diekstrak dari pencocokan kueri 'good story' di kolom content:
FieldExpression(name='snippet', 'snippet("good story", content)')
Dengan kueri ini, API akan menampilkan ScoredDocument.expression berikut:
HtmlField(name='snippet', value='that was a good story to finish')
- cursor
Kursor yang dikaitkan dengan hasil yang digunakan sebagai titik awal untuk menampilkan kumpulan hasil penelusuran berikutnya. Properti ini tidak akan ditampilkan kecuali jika Anda menetapkan Index.cursor_type ke Index.RESULT_CURSOR; jika tidak, properti akan ditampilkan menjadi None.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-19 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-19 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eScoredDocument\u003c/code\u003e class represents a scored document returned from a search operation and is not manually constructed but rather received as a result from \u003ccode\u003eIndex.search()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eIt includes properties such as \u003ccode\u003edoc_id\u003c/code\u003e, \u003ccode\u003efields\u003c/code\u003e, \u003ccode\u003elanguage\u003c/code\u003e, \u003ccode\u003esort_scores\u003c/code\u003e, \u003ccode\u003eexpressions\u003c/code\u003e, \u003ccode\u003ecursor\u003c/code\u003e, and \u003ccode\u003erank\u003c/code\u003e which provide details about the document and its ranking.\u003c/p\u003e\n"],["\u003cp\u003eThe class allows the retrieval of scores generated during the sorting process (\u003ccode\u003esort_scores\u003c/code\u003e), computed fields from requested expressions (\u003ccode\u003eexpressions\u003c/code\u003e), and a cursor for paginated results (\u003ccode\u003ecursor\u003c/code\u003e) if configured.\u003c/p\u003e\n"],["\u003cp\u003eIf no \u003ccode\u003edoc_id\u003c/code\u003e is specified, one will be assigned by the search service.\u003c/p\u003e\n"],["\u003cp\u003eThe document's \u003ccode\u003erank\u003c/code\u003e property determines the order in which it appears in search results, with a higher \u003ccode\u003erank\u003c/code\u003e meaning the document is returned earlier in the results.\u003c/p\u003e\n"]]],[],null,["# class ScoredDocument\n\nClass `ScoredDocument` represents a scored document returned from a search. You do not build this class explicitly; rather, it is returned as a result of [Index.search()](/appengine/docs/legacy/standard/python/search/indexclass).\n| This API is supported for first-generation runtimes and can be used when [upgrading to corresponding second-generation runtimes](/appengine/docs/standard/\n| python3\n|\n| /services/access). If you are updating to the App Engine Python 3 runtime, refer to the [migration guide](/appengine/migration-center/standard/migrate-to-second-gen/python-differences) to learn about your migration options for legacy bundled services.\n\n`ScoredDocument` is defined in the `google.appengine.api.search` module.\n\nConstructor\n-----------\n\nThe constructor for class `MatchScorer` is defined as follows:\n\n\nclass ScoredDocument(doc_id=None, fields=None, language='en', sort_scores=None, expressions=None, cursor=None, rank=None)\n\n:\n\n Represents a scored document returned from a search.\n\n \u003cbr /\u003e\n\n:\n\n Arguments\n\n doc_id\n\n : The visible, printable ASCII string identifying the document. Must not begin with '!'. Whitespace is excluded from ids. If no id is provided, the search service will provide one.\n\n fields\n\n : An iterable of Field instances representing the content of the document.\n\n language\n\n : The two-letter [ISO 639.2 language code](http://www.loc.gov/standards/iso639-2/php/code_list.php) of the language used in the field values.\n\n sort_scores\n\n : The list of scores assigned during sort evaluation. Each sort dimension is included. Positive scores are used for ascending sorts; negative scores for descending.\n\n expressions\n\n : The list of computed fields which are the result of expressions requested.\n\n cursor\n\n : A cursor associated with the document.\n\n rank\n\n : The document rank is used to specify the order this document will be returned in search results, where 0 \\\u003c= rank \\\u003c= sys.maxint. If not specified, the number of seconds since 1st Jan 2011 is used. Documents are returned in descending order of the order ID.\n\n Result value\n\n : A new instance of class `ScoredDocument`.\n\n Exceptions\n\n TypeError\n\n : If any of the parameters have an invalid type, or an unknown attribute is passed.\n\n ValueError\n\n : If any parameter has an invalid value.\n\n \u003cbr /\u003e\n\nProperties\n----------\n\nAn instance of class `ScoredDocument` has the following properties:\n\nsort_scores\n\n: Returns the list of scores assigned while the API is sorting the results of a search. Each sort dimension is included. Positive scores are used for ascending sorts and negative scores for descending.\n\nexpressions\n\n: The list of computed fields the result of expression evaluation. For example, the following [field expression](/appengine/docs/legacy/standard/python/search/fieldexpressionclass) seeks to compute a snippet field containing HTML snippets extracted from the matching of the query `'good story'` in the `content` field:\n\n ```python\n FieldExpression(name='snippet', 'snippet(\"good story\", content)')\n ```\n Given this query, the API would return the following `ScoredDocument.expression`: \n\n ```python\n HtmlField(name='snippet', value='that was a good story to finish')\n ```\n\n \u003cbr /\u003e\n\ncursor\n\n: A cursor associated with a result used as a starting point from which to return the next set of search results. This property will not return unless you set the `Index.cursor_type` to `Index.RESULT_CURSOR`; otherwise the property returns be `None`."]]
