API Google Knowledge Graph Search

Questa guida rapida introduce l'API Google Knowledge Graph Search. In questa guida rapida, utilizza l'API per cercare o consultare entità in Google Knowledge Graph.

Se stai pianificando un nuovo progetto, crea la tua applicazione con Cloud Knowledge Graph Advanced edition per sfruttare le nuove funzionalità e i miglioramenti del servizio. La versione Basic rimane disponibile, ma non supporta nuove funzionalità, QPS elevato o ulteriori standard di sicurezza e conformità.

Cercare entità Knowledge Graph di Cloud

Gli esempi riportati di seguito mostrano come cercare un'entità nel knowledge graph.

Avanzato

REST

Per cercare nel Knowledge Graph per Advanced, chiama il metodo projects.locations.cloudKnowledgeGraphEntities.search.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

PROJECT_ID: l'ID progetto Google Cloud .
LOCATION: la posizione del Knowledge Graph.
- Opzioni: global - Endpoint globale
SEARCH_QUERY: La stringa di query letterale per la ricerca.
LANGUAGES: (facoltativo) l'elenco dei codici lingua (definiti in ISO 693) con cui eseguire la query. Se non è specificato, il valore predefinito è en.
TYPES: (facoltativo) limita le entità restituite a questi tipi, come definito da `https://schema.org`. Se vengono specificati più tipi, le entità restituite conterranno uno o più di questi tipi. Il valore predefinito è vuoto, il che restituirà entità senza limitazioni di tipo. Per i tipi supportati, consulta la gerarchia completa di schema.org.
Suggerimento:se sai cosa stai cercando, utilizza il filtro Tipi per restringere la ricerca.
LIMIT: (facoltativo) limita il numero di entità da restituire. Il valore predefinito è 20.

Metodo HTTP e URL:

GET https://enterpriseknowledgegraph.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/cloudKnowledgeGraphEntities:Search?query=SEARCH_QUERY&limit=LIMIT

Per inviare la richiesta, scegli una di queste opzioni:

curl

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://enterpriseknowledgegraph.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/cloudKnowledgeGraphEntities:Search?query=SEARCH_QUERY&limit=LIMIT"

PowerShell

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://enterpriseknowledgegraph.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/cloudKnowledgeGraphEntities:Search?query=SEARCH_QUERY&limit=LIMIT" | Select-Object -Expand Content

La risposta contiene un elenco di entità, presentata in formato JSON-LD e compatibile con gli schemi schema.org con estensioni esterne limitate.

Per ulteriori informazioni sulla struttura della risposta, consulta Struttura della risposta dell'entità.

Il seguente esempio JSON-LD mostra la struttura del corpo della risposta:

{
  "@context": {
    "@vocab": "http://schema.org/"
  },
  "@type": "ItemList",
  "itemListElement": [
    {
      "result": {
        "@id": "c-07xuup16g",
        "name": "Stanford University",
        "description": "Private university in Stanford, California",
        "detailedDescription": {
          "articleBody": "Stanford University, officially Leland Stanford Junior University, is a private research university in Stanford, California. The campus occupies 8,180 acres, among the largest in the United States, and enrolls over 17,000 students. ",
          "url": "https://en.wikipedia.org/wiki/Stanford_University",
          "license": "https://en.wikipedia.org/wiki/Wikipedia:Text_of_Creative_Commons_Attribution-ShareAlike_3.0_Unported_License"
        },
        "url": "http://www.stanford.edu/",
        "image": {
          "contentUrl": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTfPPf-ker0y_892m1wu8-U89furQgQ67foDFncY3r9sREpeWxV",
          "url": "https://es.wikipedia.org/wiki/Archivo:Logo_of_Stanford_University.png"
        },
        "identifier": [
          {
            "@type": "PropertyValue",
            "propertyID": "googleKgMID",
            "value": "/m/06pwq"
          },
          {
            "@type": "PropertyValue",
            "propertyID": "googlePlaceID",
            "value": "ChIJneqLZyq7j4ARf2j8RBrwzSk"
          },
          {
            "@type": "PropertyValue",
            "propertyID": "wikidataQID",
            "value": "Q41506"
          }
        ],
        "@type": [
          "Place",
          "Organization",
          "MovieTheater",
          "Corporation",
          "EducationalOrganization",
          "Thing",
          "CollegeOrUniversity"
        ]
      }
    }
  ]
}

Python

Per saperne di più, consulta la documentazione di riferimento dell'API Enterprise Knowledge Graph Python.

Per eseguire l'autenticazione in Enterprise Knowledge Graph, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.


from __future__ import annotations

from collections.abc import Sequence

from google.cloud import enterpriseknowledgegraph as ekg

# TODO(developer): Uncomment these variables before running the sample.
# project_id = 'YOUR_PROJECT_ID'
# location = 'YOUR_GRAPH_LOCATION'      # Values: 'global'
# search_query = 'YOUR_SEARCH_QUERY'
# languages = ['en']                    # Optional: List of ISO 639-1 Codes
# types = ['']                          # Optional: List of schema.org types to return
# limit = 20                            # Optional: Number of entities to return


def search_sample(
    project_id: str,
    location: str,
    search_query: str,
    languages: Sequence[str] = None,
    types: Sequence[str] = None,
    limit: int = 20,
):
    # Create a client
    client = ekg.EnterpriseKnowledgeGraphServiceClient()

    # The full resource name of the location
    # e.g. projects/{project_id}/locations/{location}
    parent = client.common_location_path(project=project_id, location=location)

    # Initialize request argument(s)
    request = ekg.SearchRequest(
        parent=parent,
        query=search_query,
        languages=languages,
        types=types,
        limit=limit,
    )

    # Make the request
    response = client.search(request=request)

    print(f"Search Query: {search_query}\n")

    # Extract and print date from response
    for item in response.item_list_element:
        result = item.get("result")

        print(f"Name: {result.get('name')}")
        print(f"- Description: {result.get('description')}")
        print(f"- Types: {result.get('@type')}\n")

        detailed_description = result.get("detailedDescription")

        if detailed_description:
            print("- Detailed Description:")
            print(f"\t- Article Body: {detailed_description.get('articleBody')}")
            print(f"\t- URL: {detailed_description.get('url')}")
            print(f"\t- License: {detailed_description.get('license')}\n")

        print(f"- Cloud MID: {result.get('@id')}")
        for identifier in result.get("identifier"):
            print(f"\t- {identifier.get('name')}: {identifier.get('value')}")

        print("\n")

Di base

REST

Per cercare nel knowledge graph per l'edizione Basic, chiama il metodo projects.locations.publicKnowledgeGraphEntities.search.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

PROJECT_ID: l'ID progetto Google Cloud .
LOCATION: la posizione del Knowledge Graph.
- Opzioni: global - Endpoint globale
SEARCH_QUERY: La stringa di query letterale per la ricerca.
LANGUAGES: (facoltativo) l'elenco dei codici lingua (definiti in ISO 693) con cui eseguire la query. Se non è specificato, il valore predefinito è en.
TYPES: (facoltativo) limita le entità restituite a questi tipi, come definito da `https://schema.org`. Se vengono specificati più tipi, le entità restituite conterranno uno o più di questi tipi. Il valore predefinito è vuoto, il che restituirà entità senza limitazioni di tipo. Per i tipi supportati, consulta la gerarchia completa di schema.org.
Suggerimento:se sai cosa stai cercando, utilizza il filtro Tipi per restringere la ricerca.
LIMIT: (facoltativo) limita il numero di entità da restituire. Il valore predefinito è 20.

Metodo HTTP e URL:

GET https://enterpriseknowledgegraph.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publicKnowledgeGraphEntities:Search?query=SEARCH_QUERY&limit=LIMIT

Per inviare la richiesta, scegli una di queste opzioni:

curl

Esegui questo comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://enterpriseknowledgegraph.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publicKnowledgeGraphEntities:Search?query=SEARCH_QUERY&limit=LIMIT"

PowerShell

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://enterpriseknowledgegraph.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publicKnowledgeGraphEntities:Search?query=SEARCH_QUERY&limit=LIMIT" | Select-Object -Expand Content

La risposta contiene un elenco di entità, presentata in formato JSON-LD e compatibile con gli schemi schema.org con estensioni esterne limitate.

Per ulteriori informazioni sulla struttura della risposta, consulta Struttura della risposta dell'entità.

Il seguente esempio JSON-LD mostra la struttura del corpo della risposta:

{
  "@context": {
    "@vocab": "http://schema.org/"
  },
  "@type": "ItemList",
  "itemListElement": [
    {
      "result": {
        "@id": "c-07xuup16g",
        "name": "Stanford University",
        "description": "Private university in Stanford, California",
        "detailedDescription": {
          "license": "https://en.wikipedia.org/wiki/Wikipedia:Text_of_Creative_Commons_Attribution-ShareAlike_3.0_Unported_License",
          "url": "https://en.wikipedia.org/wiki/Stanford_University",
          "articleBody": "Stanford University, officially Leland Stanford Junior University, is a private research university in Stanford, California. The campus occupies 8,180 acres, among the largest in the United States, and enrolls over 17,000 students. "
        },
        "url": "http://www.stanford.edu/",
        "identifier": [
          {
            "@type": "PropertyValue",
            "propertyID": "googleKgMID",
            "value": "/m/06pwq"
          }
        ],
        "image": {
          "contentUrl": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTfPPf-ker0y_892m1wu8-U89furQgQ67foDFncY3r9sREpeWxV",
          "url": "https://es.wikipedia.org/wiki/Archivo:Logo_of_Stanford_University.png"
        },
        "@type": [
          "EducationalOrganization",
          "CollegeOrUniversity",
          "Thing",
          "Place",
          "Corporation",
          "MovieTheater",
          "Organization"
        ]
      }
    }
  ]
}

Python

Per saperne di più, consulta la documentazione di riferimento dell'API Enterprise Knowledge Graph Python.


from __future__ import annotations

from collections.abc import Sequence

from google.cloud import enterpriseknowledgegraph as ekg

# TODO(developer): Uncomment these variables before running the sample.
# project_id = 'YOUR_PROJECT_ID'
# location = 'YOUR_GRAPH_LOCATION'      # Values: 'global'
# search_query = 'YOUR_SEARCH_QUERY'
# languages = ['en']                    # Optional: List of ISO 639-1 Codes
# types = ['']                          # Optional: List of schema.org types to return
# limit = 20                            # Optional: Number of entities to return


def search_public_kg_sample(
    project_id: str,
    location: str,
    search_query: str,
    languages: Sequence[str] = None,
    types: Sequence[str] = None,
    limit: int = 20,
):
    # Create a client
    client = ekg.EnterpriseKnowledgeGraphServiceClient()

    # The full resource name of the location
    # e.g. projects/{project_id}/locations/{location}
    parent = client.common_location_path(project=project_id, location=location)

    # Initialize request argument(s)
    request = ekg.SearchPublicKgRequest(
        parent=parent,
        query=search_query,
        languages=languages,
        types=types,
        limit=limit,
    )

    # Make the request
    response = client.search_public_kg(request=request)

    print(f"Search Query: {search_query}\n")

    # Extract and print date from response
    for item in response.item_list_element:
        result = item.get("result")

        print(f"Name: {result.get('name')}")
        print(f"- Description: {result.get('description')}")
        print(f"- Types: {result.get('@type')}\n")

        detailed_description = result.get("detailedDescription")

        if detailed_description:
            print("- Detailed Description:")
            print(f"\t- Article Body: {detailed_description.get('articleBody')}")
            print(f"\t- URL: {detailed_description.get('url')}")
            print(f"\t- License: {detailed_description.get('license')}\n")

        print(f"- Cloud MID: {result.get('@id')}")
        for identifier in result.get("identifier"):
            print(f"\t- {identifier.get('name')}: {identifier.get('value')}")

        print("\n")

Cercare entità dall'ID Cloud Knowledge Graph

L'API Google Knowledge Graph Search introduce il nuovo formato ID macchina (MID) per una più facile integrazione di prodotti e applicazioni. L'API lookup funziona sia per il nuovo MID Cloud Knowledge Graph (che inizia con c-) sia per il MID Google Knowledge Graph (che inizia con /m).

Avanzato

REST

Per cercare un'entità per MID per la versione Advanced, chiama il metodo projects.locations.cloudKnowledgeGraphEntities.lookup.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

PROJECT_ID: l'ID progetto Google Cloud .
LOCATION: la posizione del Knowledge Graph.
- Opzioni: global - Endpoint globale
LOOKUP_IDS: L'elenco degli ID entità da utilizzare per la ricerca.
- Esempio: /m/0dl567
LANGUAGES: (facoltativo) l'elenco dei codici lingua (definiti in ISO 693) con cui eseguire la query. Se non è specificato, il valore predefinito è en.

Metodo HTTP e URL:

GET https://enterpriseknowledgegraph.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/cloudKnowledgeGraphEntities:Lookup?ids=LOOKUP_IDS

Per inviare la richiesta, scegli una di queste opzioni:

curl

Esegui questo comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://enterpriseknowledgegraph.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/cloudKnowledgeGraphEntities:Lookup?ids=LOOKUP_IDS"

PowerShell

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://enterpriseknowledgegraph.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/cloudKnowledgeGraphEntities:Lookup?ids=LOOKUP_IDS" | Select-Object -Expand Content

La risposta contiene un elenco di entità, presentata in formato JSON-LD e compatibile con gli schemi schema.org con estensioni esterne limitate.

Per ulteriori informazioni sulla struttura della risposta, consulta Struttura della risposta dell'entità.

Il seguente esempio JSON-LD mostra la struttura del corpo della risposta:

{
  "@context": {
    "@vocab": "http://schema.org/"
  },
  "@type": "ItemList",
  "itemListElement": [
    {
      "result": {
        "description": "American singer-songwriter",
        "@type": [
          "Person",
          "Thing"
        ],
        "name": "Taylor Swift",
        "@id": "c-0260160kc",
        "url": "http://www.taylorswift.com/",
        "identifier": [
          {
            "@type": "PropertyValue",
            "propertyID": "googleKgMID",
            "value": "/m/0dl567"
          },
          {
            "@type": "PropertyValue",
            "propertyID": "wikidataQID",
            "value": "Q26876"
          }
        ],
        "detailedDescription": {
          "articleBody": "Taylor Alison Swift is an American singer-songwriter. Her discography spans multiple genres and her narrative songwriting—often inspired by her personal life—has received critical praise and widespread media coverage. ",
          "license": "https://en.wikipedia.org/wiki/Wikipedia:Text_of_Creative_Commons_Attribution-ShareAlike_3.0_Unported_License",
          "url": "https://en.wikipedia.org/wiki/Taylor_Swift"
        },
        "image": {
          "contentUrl": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSnsjOArwgD-bhyRslj_Qa7Z2tIPLRFU3VnEuLr1ybcyned49Pt",
          "url": "https://pt.wikipedia.org/wiki/Ficheiro:191125_Taylor_Swift_at_the_2019_American_Music_Awards_(cropped).png"
        }
      }
    }
  ]
}

Per cercare più entità da Cloud Knowledge Graph, fornisci più ID. L'URL dovrebbe essere simile a questo.

https://enterpriseknowledgegraph.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/cloudKnowledgeGraphEntities:Lookup?ids=LOOKUP_IDS&ids=LOOKUP_IDS

Python

Per saperne di più, consulta la documentazione di riferimento dell'API Enterprise Knowledge Graph Python.


from __future__ import annotations

from collections.abc import Sequence

from google.cloud import enterpriseknowledgegraph as ekg

# TODO(developer): Uncomment these variables before running the sample.
# project_id = 'YOUR_PROJECT_ID'
# location = 'YOUR_GRAPH_LOCATION'      # Values: 'global'
# ids = ['YOUR_LOOKUP_MID']             # https://cloud.google.com/enterprise-knowledge-graph/docs/mid
# languages = ['en']                    # Optional: List of ISO 639-1 Codes


def lookup_sample(
    project_id: str,
    location: str,
    ids: Sequence[str],
    languages: Sequence[str] = None,
):
    # Create a client
    client = ekg.EnterpriseKnowledgeGraphServiceClient()

    # The full resource name of the location
    # e.g. projects/{project_id}/locations/{location}
    parent = client.common_location_path(project=project_id, location=location)

    # Initialize request argument(s)
    request = ekg.LookupRequest(
        parent=parent,
        ids=ids,
        languages=languages,
    )

    # Make the request
    response = client.lookup(request=request)

    print(f"Lookup IDs: {ids}\n")

    print(response)

    # Extract and print date from response
    for item in response.item_list_element:
        result = item.get("result")

        print(f"Name: {result.get('name')}")
        print(f"- Description: {result.get('description')}")
        print(f"- Types: {result.get('@type')}\n")

        detailed_description = result.get("detailedDescription")

        if detailed_description:
            print("- Detailed Description:")
            print(f"\t- Article Body: {detailed_description.get('articleBody')}")
            print(f"\t- URL: {detailed_description.get('url')}")
            print(f"\t- License: {detailed_description.get('license')}\n")

        print(f"- Cloud MID: {result.get('@id')}")
        for identifier in result.get("identifier"):
            print(f"\t- {identifier.get('name')}: {identifier.get('value')}")

        print("\n")

Di base

REST

Per cercare un'entità in base al MID per la versione Basic, chiama il metodo projects.locations.publicKnowledgeGraphEntities.lookup.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

PROJECT_ID: l'ID progetto Google Cloud .
LOCATION: la posizione del Knowledge Graph.
- Opzioni: global - Endpoint globale
LOOKUP_IDS: L'elenco degli ID entità da utilizzare per la ricerca.
- Esempio: /m/0dl567
LANGUAGES: (facoltativo) l'elenco dei codici lingua (definiti in ISO 693) con cui eseguire la query. Se non è specificato, il valore predefinito è en.

Metodo HTTP e URL:

GET https://enterpriseknowledgegraph.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publicKnowledgeGraphEntities:Lookup?ids=LOOKUP_IDS

Per inviare la richiesta, scegli una di queste opzioni:

curl

Esegui questo comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://enterpriseknowledgegraph.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publicKnowledgeGraphEntities:Lookup?ids=LOOKUP_IDS"

PowerShell

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://enterpriseknowledgegraph.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publicKnowledgeGraphEntities:Lookup?ids=LOOKUP_IDS" | Select-Object -Expand Content

La risposta contiene un elenco di entità, presentata in formato JSON-LD e compatibile con gli schemi schema.org con estensioni esterne limitate.

Per ulteriori informazioni sulla struttura della risposta, consulta Struttura della risposta dell'entità.

Il seguente esempio JSON-LD mostra la struttura del corpo della risposta:

{
  "@context": {
    "@vocab": "http://schema.org/"
  },
  "@type": "ItemList",
  "itemListElement": [
    {
      "result": {
        "description": "American singer-songwriter",
        "@type": [
          "Person",
          "Thing"
        ],
        "name": "Taylor Swift",
        "@id": "c-0260160kc",
        "url": "http://www.taylorswift.com/",
        "identifier": [
          {
            "@type": "PropertyValue",
            "propertyID": "googleKgMID",
            "value": "/m/0dl567"
          }
        ],
        "detailedDescription": {
          "articleBody": "Taylor Alison Swift is an American singer-songwriter. Her discography spans multiple genres and her narrative songwriting—often inspired by her personal life—has received critical praise and widespread media coverage. ",
          "license": "https://en.wikipedia.org/wiki/Wikipedia:Text_of_Creative_Commons_Attribution-ShareAlike_3.0_Unported_License",
          "url": "https://en.wikipedia.org/wiki/Taylor_Swift"
        },
        "image": {
          "contentUrl": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSnsjOArwgD-bhyRslj_Qa7Z2tIPLRFU3VnEuLr1ybcyned49Pt",
          "url": "https://pt.wikipedia.org/wiki/Ficheiro:191125_Taylor_Swift_at_the_2019_American_Music_Awards_(cropped).png"
        }
      }
    }
  ]
}

Per cercare più entità da Cloud Knowledge Graph, fornisci più ID. L'URL dovrebbe essere simile a questo.

https://enterpriseknowledgegraph.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publicKnowledgeGraphEntities:Lookup?ids=LOOKUP_IDS&ids=LOOKUP_IDS

Python

Per saperne di più, consulta la documentazione di riferimento dell'API Enterprise Knowledge Graph Python.


from __future__ import annotations

from collections.abc import Sequence

from google.cloud import enterpriseknowledgegraph as ekg

# TODO(developer): Uncomment these variables before running the sample.
# project_id = 'YOUR_PROJECT_ID'
# location = 'YOUR_GRAPH_LOCATION'      # Values: 'global'
# ids = ['YOUR_LOOKUP_MID']             # https://cloud.google.com/enterprise-knowledge-graph/docs/mid
# languages = ['en']                    # Optional: List of ISO 639-1 Codes


def lookup_public_kg_sample(
    project_id: str,
    location: str,
    ids: Sequence[str],
    languages: Sequence[str] = None,
):
    # Create a client
    client = ekg.EnterpriseKnowledgeGraphServiceClient()

    # The full resource name of the location
    # e.g. projects/{project_id}/locations/{location}
    parent = client.common_location_path(project=project_id, location=location)

    # Initialize request argument(s)
    request = ekg.LookupPublicKgRequest(
        parent=parent,
        ids=ids,
        languages=languages,
    )

    # Make the request
    response = client.lookup_public_kg(request=request)

    print(f"Lookup IDs: {ids}\n")

    print(response)

    # Extract and print date from response
    for item in response.item_list_element:
        result = item.get("result")

        print(f"Name: {result.get('name')}")
        print(f"- Description: {result.get('description')}")
        print(f"- Types: {result.get('@type')}\n")

        detailed_description = result.get("detailedDescription")

        if detailed_description:
            print("- Detailed Description:")
            print(f"\t- Article Body: {detailed_description.get('articleBody')}")
            print(f"\t- URL: {detailed_description.get('url')}")
            print(f"\t- License: {detailed_description.get('license')}\n")

        print(f"- Cloud MID: {result.get('@id')}")
        for identifier in result.get("identifier"):
            print(f"\t- {identifier.get('name')}: {identifier.get('value')}")

        print("\n")

Struttura dell'entità

Nome campo	Tipo	Descrizione
`@id`	`string`	L'URI canonico dell'entità.
`name`	`string`	Il nome dell'entità.
`@type`	`array`	L'elenco dei tipi schema.org supportati che corrispondono all'entità.
`description`	`string`	Una breve descrizione dell'entità.
`image`	`URL`	Un'immagine per identificare l'entità.
`detailedDescription`	`string`	Una descrizione dettagliata dell'entità.
`url`	`URL`	L'URL del sito web ufficiale dell'entità, se disponibile.
`identifier`	`array`	Un elenco di altri ID collegati, ad es. WikidataQID.

Parole chiave JSON-LD

Consulta la specifica JSON-LD per le parole chiave JSON-LD, ad esempio:

Compatibilità con schema.org

Per ogni tipo (ad esempio Person) e proprietà (ad esempio name) di schema.org esiste un URI completo corrispondente, come nei seguenti esempi:

Classe	Nome	URI
tipo	`Person`	`https://schema.org/Person`
tipo	`Thing`	`https://schema.org/Thing`
proprietà	`name`	`https://schema.org/name`
proprietà	`description`	`https://schema.org/description`

Estensioni dello schema

I tipi e le proprietà utilizzati in questa API sono ospitati all'indirizzo https://schema.googleapis.com come estensioni esterne.

La documentazione per ogni tipo e proprietà è disponibile all'URI corrispondente.

Classe	Nome	URI
tipo	`EntitySearchResult`	`https://schema.googleapis.com/EntitySearchResult`
proprietà	`detailedDescription`	`https://schema.googleapis.com/detailedDescription`

Entità Knowledge Graph

Il Knowledge Graph ha milioni di voci che descrivono entità del mondo reale come persone, luoghi e cose. Queste entità formano i nodi del grafico.

Di seguito sono riportati alcuni dei tipi comuni di entità trovati nel Cloud Knowledge Graph:

API Google Knowledge Graph Search Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Cercare entità Knowledge Graph di Cloud

Avanzato

REST

curl

PowerShell

Python

Di base

REST

curl

PowerShell

Python

Cercare entità dall'ID Cloud Knowledge Graph

Avanzato

REST

curl

PowerShell

Python

Di base

REST

curl

PowerShell

Python

Struttura dell'entità

Parole chiave JSON-LD

Compatibilità con schema.org

Estensioni dello schema

Entità Knowledge Graph

API Google Knowledge Graph Search