API de búsqueda del Gráfico de conocimiento de Google

Versión preliminar

Este producto está con sujeción a las "Condiciones de las Ofertas de la Fase Previa a la DG" de la sección de Términos Generales del Servicio de los Términos Específicos del Servicio. Puedes tratar datos personales para este producto, como se describe en el Anexo de Tratamiento de Datos de Cloud, con sujeción a las obligaciones y restricciones descritas en el acuerdo en virtud del cual accedes a Google Cloud. Los productos de la fase previa a la DG están disponibles sin modificaciones y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

En esta guía de inicio rápido, se presenta la API de Google Knowledge Graph Search. En esta guía de inicio rápido, usarás la API para buscar o consultar entidades en el Gráfico de conocimiento de Google.

Si planeas un proyecto nuevo, compila tu aplicación con la edición avanzada de Cloud Knowledge Graph para aprovechar las nuevas funciones y las mejoras del servicio. La edición básica sigue disponible, pero no admite funciones nuevas, QPS altas ni estándares adicionales de seguridad y cumplimiento.

Busca entidades del Gráfico de conocimiento de Cloud

En los siguientes ejemplos, se muestra cómo buscar una entidad en el gráfico de conocimiento.

Avanzado

REST

Para buscar en el gráfico de conocimiento de la edición Advanced, llama al método projects.locations.cloudKnowledgeGraphEntities.search.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT_ID: Es el ID del proyecto de Google Cloud .
LOCATION: Es la ubicación en Knowledge Graph.
- Opciones: global (extremo global)
SEARCH_QUERY: Es la cadena de búsqueda literal.
LANGUAGES: (Opcional) Es la lista de códigos de idioma (definidos en ISO 693) con los que se ejecutará la búsqueda. El valor predeterminado es en si no se especifica.
TYPES: (Opcional) Restringe las entidades devueltas con estos tipos, según se definen en "https://schema.org". Si se especifican varios tipos, las entidades devueltas contendrán uno o más de estos tipos. El valor predeterminado está vacío, lo que devolverá entidades sin restricciones de tipo. Consulta la jerarquía completa de Schema.org para ver los tipos admitidos.
Sugerencia: Si sabes lo que buscas, usa el filtro Tipos para limitar tu búsqueda.
LIMIT: (Opcional) Limita la cantidad de entidades que se devolverán. El valor predeterminado es 20.

Método HTTP y URL:

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente 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: En el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente 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 respuesta contiene una lista de entidades, presentada en formato JSON-LD y compatible con esquemas de schema.org con extensiones externas limitadas.

Consulta Estructura de respuesta de la entidad para obtener más información sobre la estructura de la respuesta.

En el siguiente ejemplo de JSON-LD, se muestra cómo se estructura el cuerpo de la respuesta:

{
  "@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

Si quieres obtener más información, consulta la documentación de referencia de la API de Enterprise Knowledge Graph para Python.

Para autenticarte en Enterprise Knowledge Graph, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.


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")

Básico

REST

Para buscar en el gráfico de conocimiento de la edición Basic, llama al método projects.locations.publicKnowledgeGraphEntities.search.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT_ID: Es el ID del proyecto de Google Cloud .
LOCATION: Es la ubicación en Knowledge Graph.
- Opciones: global (extremo global)
SEARCH_QUERY: Es la cadena de búsqueda literal.
LANGUAGES: (Opcional) Es la lista de códigos de idioma (definidos en ISO 693) con los que se ejecutará la búsqueda. El valor predeterminado es en si no se especifica.
TYPES: (Opcional) Restringe las entidades devueltas con estos tipos, según se definen en "https://schema.org". Si se especifican varios tipos, las entidades devueltas contendrán uno o más de estos tipos. El valor predeterminado está vacío, lo que devolverá entidades sin restricciones de tipo. Consulta la jerarquía completa de Schema.org para ver los tipos admitidos.
Sugerencia: Si sabes lo que buscas, usa el filtro Tipos para limitar tu búsqueda.
LIMIT: (Opcional) Limita la cantidad de entidades que se devolverán. El valor predeterminado es 20.

Método HTTP y URL:

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el siguiente 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

Ejecuta el siguiente 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 respuesta contiene una lista de entidades, presentada en formato JSON-LD y compatible con esquemas de schema.org con extensiones externas limitadas.

Consulta Estructura de respuesta de la entidad para obtener más información sobre la estructura de la respuesta.

En el siguiente ejemplo de JSON-LD, se muestra cómo se estructura el cuerpo de la respuesta:

{
  "@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

Si quieres obtener más información, consulta la documentación de referencia de la API de Enterprise Knowledge Graph para 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")

Cómo buscar entidades a partir del MID del Gráfico de conocimiento de Cloud

La API de Google Knowledge Graph Search presenta el nuevo formato de ID de máquina (MID) para facilitar la integración de productos y aplicaciones. La API de lookup funciona tanto para el nuevo MID del Gráfico de conocimiento de Cloud (comienza con c-) como para el MID del Gráfico de conocimiento de Google (comienza con /m).

Avanzado

REST

Para buscar una entidad por MID en la edición Advanced, llama al método projects.locations.cloudKnowledgeGraphEntities.lookup.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT_ID: Es el ID del proyecto de Google Cloud .
LOCATION: Es la ubicación en Knowledge Graph.
- Opciones: global (extremo global)
LOOKUP_IDS: Es la lista de IDs de entidades que se usarán para la búsqueda.
- Ejemplo: /m/0dl567
LANGUAGES: (Opcional) Es la lista de códigos de idioma (definidos en ISO 693) con los que se ejecutará la búsqueda. El valor predeterminado es en si no se especifica.

Método HTTP y URL:

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el siguiente 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

Ejecuta el siguiente 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 respuesta contiene una lista de entidades, presentada en formato JSON-LD y compatible con esquemas de schema.org con extensiones externas limitadas.

Consulta Estructura de respuesta de la entidad para obtener más información sobre la estructura de la respuesta.

En el siguiente ejemplo de JSON-LD, se muestra cómo se estructura el cuerpo de la respuesta:

{
  "@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"
        }
      }
    }
  ]
}

Para buscar varias entidades en el Gráfico de conocimiento de Cloud, proporciona varios IDs. La URL debería verse así.

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

Python

Si quieres obtener más información, consulta la documentación de referencia de la API de Enterprise Knowledge Graph para 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")

Básico

REST

Para buscar una entidad por MID en la edición Basic, llama al método projects.locations.publicKnowledgeGraphEntities.lookup.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT_ID: Es el ID del proyecto de Google Cloud .
LOCATION: Es la ubicación en Knowledge Graph.
- Opciones: global (extremo global)
LOOKUP_IDS: Es la lista de IDs de entidades que se usarán para la búsqueda.
- Ejemplo: /m/0dl567
LANGUAGES: (Opcional) Es la lista de códigos de idioma (definidos en ISO 693) con los que se ejecutará la búsqueda. El valor predeterminado es en si no se especifica.

Método HTTP y URL:

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el siguiente 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

Ejecuta el siguiente 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 respuesta contiene una lista de entidades, presentada en formato JSON-LD y compatible con esquemas de schema.org con extensiones externas limitadas.

Consulta Estructura de respuesta de la entidad para obtener más información sobre la estructura de la respuesta.

En el siguiente ejemplo de JSON-LD, se muestra cómo se estructura el cuerpo de la respuesta:

{
  "@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"
        }
      }
    }
  ]
}

Para buscar varias entidades en el Gráfico de conocimiento de Cloud, proporciona varios IDs. La URL debería verse así.

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

Python

Si quieres obtener más información, consulta la documentación de referencia de la API de Enterprise Knowledge Graph para 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")

Estructura de la entidad

Nombre del campo	Tipo	Descripción
`@id`	`string`	Es el URI canónico de la entidad.
`name`	`string`	Es el nombre de la entidad.
`@type`	`array`	Es la lista de tipos de schema.org admitidos que coinciden con la entidad.
`description`	`string`	Es una descripción breve de la entidad.
`image`	`URL`	Es una imagen que ayuda a identificar la entidad.
`detailedDescription`	`string`	Es una descripción detallada de la entidad.
`url`	`URL`	Es la URL del sitio web oficial de la entidad, si está disponible.
`identifier`	`array`	Es una lista de otros IDs vinculados, p. ej., WikidataQID.

Palabras clave de JSON-LD

Consulta la especificación de JSON-LD para conocer las palabras clave de JSON-LD, como las siguientes:

Compatibilidad con Schema.org

Para cada uno de los tipos (como Person) y las propiedades (como name) de Schema.org, hay un URI completo correspondiente, como en los siguientes ejemplos:

Clase	Nombre	URI
tipo	`Person`	`https://schema.org/Person`
tipo	`Thing`	`https://schema.org/Thing`
propiedad	`name`	`https://schema.org/name`
propiedad	`description`	`https://schema.org/description`

Extensiones de esquema

Los tipos y las propiedades que se usan en esta API se alojan en https://schema.googleapis.com como extensiones externas.

La documentación de cada tipo y propiedad está disponible en el URI correspondiente.

Clase	Nombre	URI
tipo	`EntitySearchResult`	`https://schema.googleapis.com/EntitySearchResult`
propiedad	`detailedDescription`	`https://schema.googleapis.com/detailedDescription`

Entidades del Gráfico de conocimiento

El Gráfico de conocimiento tiene millones de entradas que describen entidades del mundo real, como personas, lugares y objetos. Estas entidades forman los nodos del gráfico.

A continuación, se mencionan algunos de los tipos de entidades comunes que se encuentran en Cloud Knowledge Graph:

API de búsqueda del Gráfico de conocimiento de Google Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Busca entidades del Gráfico de conocimiento de Cloud

Avanzado

REST

curl

PowerShell

Python

Básico

REST

curl

PowerShell

Python

Cómo buscar entidades a partir del MID del Gráfico de conocimiento de Cloud

Avanzado

REST

curl

PowerShell

Python

Básico

REST

curl

PowerShell

Python

Estructura de la entidad

Palabras clave de JSON-LD

Compatibilidad con Schema.org

Extensiones de esquema

Entidades del Gráfico de conocimiento

API de búsqueda del Gráfico de conocimiento de Google