Method entity.search

Menelusuri Pustaka Pengetahuan untuk entitas yang cocok dengan batasan.

Permintaan HTTP

GET https://kgsearch.googleapis.com/v1/entities:search

Parameter kueri

Nama parameter	Jenis	Deskripsi
query	string	String literal yang akan ditelusuri di Pustaka Pengetahuan.
ids	string	Daftar ID entitas yang dapat ditelusuri di Pustaka Pengetahuan. Untuk menentukan beberapa ID dalam permintaan HTTP, ulangi parameter dalam URL seperti pada ...?ids=A&ids=B
languages	string	Daftar kode bahasa (ditentukan dalam ISO 639) untuk menjalankan kueri, misalnya `en`.
types	string	Membatasi entity yang ditampilkan ke entity jenis yang ditentukan. Misalnya, Anda dapat menentukan `Person` (sebagaimana dijelaskan dalam http://schema.org/Person) untuk membatasi hasil pada entitas yang mewakili orang-orang. Jika ada beberapa jenis yang ditentukan, entity yang ditampilkan akan berisi satu atau beberapa jenis ini.
indent	boolean	Mengaktifkan indentasi hasil JSON.
prefix	boolean	Mengaktifkan pencocokan awalan (substring awal) terhadap nama dan alias entitas. Misalnya, awalan `Jung` akan cocok dengan entitas dan alias seperti sebagai `Jung`, `Jungle`, dan `Jung-ho Kang`.
limit	number	Membatasi jumlah entity yang akan ditampilkan. Jumlah maksimumnya adalah 500. Defaultnya adalah 20. Permintaan dengan batas tinggi memiliki peluang waktu tunggu yang lebih tinggi.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Pesan respons berisi daftar entitas, yang disajikan di JSON-LD dan kompatibel dengan Skema schema.org (dengan ekstensi eksternal terbatas).

Contoh JSON-LD berikut menunjukkan cara struktur isi respons:

{
  "@context": {
    "@vocab": "http://schema.org/",
    "goog": "http://schema.googleapis.com/",
    "resultScore": "goog:resultScore",
    "detailedDescription": "goog:detailedDescription",
    "EntitySearchResult": "goog:EntitySearchResult",
    "kg": "http://g.co/kg"
  },
  "@type": "ItemList",
  "itemListElement": [
    {
      "@type": "EntitySearchResult",
      "result": {
        "@id": "kg:/m/0dl567",
        "name": "Taylor Swift",
        "@type": [
          "Thing",
          "Person"
        ],
        "description": "Singer-songwriter",
        "image": {
          "contentUrl": "https://t1.gstatic.com/images?q=tbn:ANd9GcQmVDAhjhWnN2OWys2ZMO3PGAhupp5tN2LwF_BJmiHgi19hf8Ku",
          "url": "https://en.wikipedia.org/wiki/Taylor_Swift",
          "license": "http://creativecommons.org/licenses/by-sa/2.0"
        },
        "detailedDescription": {
          "articleBody": "Taylor Alison Swift is an American singer-songwriter and actress. Raised in Wyomissing, Pennsylvania, she moved to Nashville, Tennessee, at the age of 14 to pursue a career in country music. ",
          "url": "http://en.wikipedia.org/wiki/Taylor_Swift",
          "license": "https://en.wikipedia.org/wiki/Wikipedia:Text_of_Creative_Commons_Attribution-ShareAlike_3.0_Unported_License"
        },
        "url": "http://taylorswift.com/"
      },
      "resultScore": 4850
    }
  ]
}

Kolom respons

Nama kolom	Jenis	Deskripsi
@id	string	URI kanonis untuk entity.
name	string	Nama entity.
@type	array	Daftar jenis schema.org yang didukung dan cocok dengan entity.
description	string	Deskripsi singkat tentang entity.
image	URL	Gambar untuk membantu mengidentifikasi entity.
detailedDescription	string	Deskripsi mendetail tentang entity.
url	URL	URL situs resmi entitas, jika tersedia.
resultScore	number	Indikator seberapa baik entitas cocok dengan batasan permintaan.

Catatan: URL gambar disediakan untuk membantu Anda mengonfirmasi bahwa Anda telah memilih entitas yang benar. Seperti semua konten yang Anda peroleh melalui Google API, Anda bertanggung jawab untuk memastikan bahwa penggunaan gambar oleh Anda mematuhi hukum.

Kata kunci JSON-LD

Untuk kata kunci JSON-LD seperti @context , @vocab, @type, atau @id, lihat Spesifikasi JSON-LD.

Kompatibilitas schema.org

Respons menggunakan kosakata yang dihosting di schema.org, dengan ekstensi terbatas (untuk misalnya, resultScore) yang kompatibel dengan kosakata schema.org. Untuk detail selengkapnya tentang ekstensi ini, lihat Daftar ekstensi skema.

Untuk setiap jenis Schema.org (seperti Person) dan properti (seperti name) ada URI lengkap yang sesuai, seperti dalam contoh berikut:

• Orang -> http://schema.org/Person

• Hal -> http://schema.org/Thing

• nama -> http://schema.org/name

• deskripsi -> http://schema.org/description

Jenis dan properti yang ditentukan sebagai ekstensi skema Google dapat diperluas dengan http://schema.googleapis.com. Misalnya,

• HasilPenelusuran Entity -> http://schema.googleapis.com/EntitySearchResult
• detailsDescription -> http://schema.googleapis.com/detailedDescription

Dokumentasi untuk setiap jenis dan properti tersedia di URI terkait.

Daftar ekstensi skema

Ekstensi skema yang digunakan dalam API ini dihosting di http://schema.googleapis.com sebagai ekstensi eksternal.

Ekstensi type untuk Schema.org adalah:

• EntitySearchResult

Ekstensi properti ke Schema.org adalah:

• detailedDescription
• resultScore