Migrate from legacy Google Knowledge Graph Search API

Preview

This product is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms . You can process personal data for this product as outlined in the Cloud Data Processing Addendum , subject to the obligations and restrictions described in the agreement under which you access Google Cloud. Pre-GA products are available "as is" and might have limited support. For more information, see the launch stage descriptions .

Updates to the request

1. New Google Knowledge Graph Search API introduces two editions, Basic and Advanced . For more information, see Basic and Advanced editions .

2. To support security and compliance requirements, move to a new prediction endpoint. If planning to use the Basic edition, use a new access token or a service account for this API and replace your endpoint URL as shown here:

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

 https://enterpriseknowledgegraph.googleapis.com/v1/projects/ PROJECT_ID 
/locations/global/publicKnowledgeGraphEntities 

Updates to the response

1. Cloud Knowledge Graph MID becomes the primary MID ( identifier ) for the entity. You can still find the Google Knowledge Graph MID in the identifier section for backward compatibility. For more information, see Understand Machine ID (MID) .

     "identifier" 
    : 
     
    [ 
     
    { 
     
    "@type" 
    : 
     
    "PropertyValue" 
    , 
     
    "propertyID" 
    : 
     
    "googleKgMID" 
    , 
     
    "value" 
    : 
     
    "/m/06pwq" 
     
    } 
    ] 
    
   

2. The additionalProperty has been added to describe the license requirement for the name field.

     "additionalProperty" 
    : 
     
    { 
     
    "@type" 
    : 
     
    "PropertyValue" 
    , 
     
    "name" 
    : 
     
    "nameLicense" 
    , 
     
    "value" 
    : 
     
    "https://cloud.google.com/maps-platform/terms" 
    } 
    
   

3. The resultScore field has been removed from the response.