以前の Google Knowledge Graph Search API から移行する

プレビュー

このプロダクトは サービス固有の 規約の「一般サービス規約」セクションの「一般提供前サービス規約」の対象となります。 お客様はこのプロダクトの個人データを Cloud のデータ処理に関する追加条項に記載されているとおりに処理できます。ただし、Google Cloud へのアクセスに関する契約に記載されている義務と制限事項が適用されます。 pre-GA のプロダクトは「現状のまま」利用できますが、サポートが制限されることがあります。 詳細については、 リリース ステージの説明をご覧ください。

注: Google ナレッジグラフ Search API は、相互接続されたエンティティのグラフではなく、一致する個々のエンティティのみを返します。相互接続されたエンティティが必要な場合は、代わりに Wikidata のデータダンプを使用してください。

リクエストの更新

1. 新しい Google ナレッジグラフ Search API には、Basic エディションと Advanced エディションの 2 つのエディションがあります。詳細については、Basic エディションと Advanced エディションをご覧ください。

2. セキュリティとコンプライアンスの要件をサポートするため、新しい予測エンドポイントに移行します。Basic エディションを使用する場合は、この API の新しいアクセス トークンまたはサービス アカウントを使用し、次のようにエンドポイント URL を置き換えます。

レガシー

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

更新

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

レスポンスの更新

1. Cloud ナレッジグラフ MID がエンティティのプライマリ MID（identifier）になります。下位互換性のため、Google ナレッジグラフ MID は identifier セクションに引き続き表示されます。詳細については、マシン ID（MID）についてをご覧ください。

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

2. name フィールドのライセンス要件を説明するために、additionalProperty が追加されました。

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

3. resultScore フィールドがレスポンスから削除されました。