クライアント ライブラリ

このページでは、HomeGraph API にアクセスする便利な方法について説明します。

Home Graph API クライアント ライブラリ

Home Graph API は HTTP と JSON を基に構築されているため、標準の HTTP クライアントであれば、この API にリクエストを送信してレスポンスを解析できます。

ただし、手動で HTTP リクエストを作成してレスポンスを解析するのではなく、Google API クライアント ライブラリを使用することをおすすめします。クライアント ライブラリを使用すると、言語が高度に統合され、セキュリティも強化されます。また、ユーザー認証が必要な呼び出しもサポートされます。

Go

最新の Go 用 Home Graph API クライアント ライブラリ（アルファ版）を取得します。クライアント ライブラリのデベロッパー ガイドをご覧ください。

Java

このページでは、Java 用 Google API クライアント ライブラリを使用して HomeGraph API の使用を開始する方法について説明します。詳細については、以下のドキュメントをご覧ください。

クライアント ライブラリをプロジェクトに追加する

以下のタブからビルド環境（Maven または Gradle）を選択します。

JavaScript

クライアント ライブラリのデベロッパー ガイドをご覧ください。

.NET

このページでは、.NET 用 Google API クライアント ライブラリを使用して HomeGraph API の使用を開始する方法について説明します。詳細については、次のドキュメントをご覧ください。

ライブラリのダウンロード

NuGet パッケージ Google.Apis をインストールします。

Node.js

最新の Node.js 用 Home Graph API クライアント ライブラリを取得します。クライアント ライブラリのデベロッパー ガイドをご覧ください。

Objective-C

最新の Objective-C 用 Home Graph API クライアント ライブラリを取得します。クライアント ライブラリのデベロッパー ガイドをご覧ください。

PHP

最新の PHP 用 Home Graph API クライアント ライブラリ（ベータ版）を取得します。クライアント ライブラリのデベロッパー ガイドをご覧ください。

Python

このページでは、Python 用 Google API クライアント ライブラリを使用して HomeGraph API の使用を開始する方法について説明します。詳細については、以下のドキュメントをご覧ください。

システム要件

クライアント ライブラリをインストールする

パッケージ マネージャーを使用するか、Python クライアント ライブラリを手動でダウンロードしてインストールできます。

マネージド インストール

pip または setuptools を使用してインストールを管理します。最初に sudo の実行が必要になる場合があります。

  • pip（推奨）: 
    pip install --upgrade google-api-python-client
  • setuptools: 
    easy_install --upgrade google-api-python-client

手動インストール

  1. 最新の Python 用クライアント ライブラリをダウンロードします。
  2. コードを解凍します。
  3. python setup.py install
    をインストールします。

App Engine

Python クライアント ライブラリは App Engine Python ランタイム環境にはインストールされていないため、サードパーティ ライブラリと同様にアプリケーションにコピーする必要があります。

Ruby

このページでは、Ruby 用 Google API クライアント ライブラリを使用して HomeGraph API の使用を開始する方法について説明します。詳細については、以下のドキュメントをご覧ください。

google-api-client gem をインストールする

システムによっては、このようなコマンドの前に sudo を付ける必要があります。

Ruby 用の Google API クライアント ライブラリをまだインストールしていない場合は、RubyGems を使用してインストールします。 

gem install google-api-client

gem がすでにインストールされている場合は、最新バージョンにアップデートします。 

gem update -y google-api-client

Ruby 用 Google API クライアント ライブラリを使ってみる

最初のリクエストをする方法については、スタートガイドをご覧ください。

Home Graph API へのその他のアクセス方法

次の表に、HomeGraph API にアクセスするその他の方法を示します。

アクセス方法 説明
API Explorer Google API をブラウザから試せるインタラクティブ ツール。

その他の図書館

スマートホームの統合に役立つその他のライブラリやリポジトリ。

ライブラリ 説明
Actions on Google Node.js ライブラリ Google スマートホーム フルフィルメントを実装するための Node.js ライブラリです。スマートホームの統合の詳細については、スマートホーム モジュールをご覧ください。
Actions on Google Java ライブラリ Google スマートホーム フルフィルメントを実装するための Java ライブラリです。Google スマートホームの統合の詳細については、スマートホーム モジュールをご覧ください。
Google スマートホーム JSON スキーマ Google スマートホームのインテントとトレイトのインターフェース用の JSON スキーマ定義のリポジトリです。サポートされている言語のライブラリ アーティファクトを生成するには、JSON スキーマ生成ツールのオプションをご覧ください。
Local Home SDK タイピング ライブラリ Local Home SDK フルフィルメントを実装するための TypeScript ライブラリです。詳細については、ローカル フルフィルメント ガイドをご覧ください。