このクイックスタート ガイドの手順を行うと、約 10 分後にゼロタッチ登録 Reseller API にリクエストを行うシンプルな Python コマンドライン アプリが作成されます。
Prerequisites
このクイックスタートを実行するには、以下が必要です。
- Google アカウント。これは、ゼロタッチ登録の販売パートナー アカウントのメンバーです。まだオンボーディングしていない場合は、販売パートナー ポータル ガイドのスタートガイドの手順を行います。
- Python 2.6 以上。
- pip パッケージ管理ツール。
- インターネットとウェブブラウザへのアクセス。
ステップ 1: ゼロタッチ登録 API を有効にする
- このウィザードを使用して、Google Developers Console でプロジェクトを作成または選択すると、API が自動的に有効になります。[続行]、[認証情報に移動] の順にクリックします。
- [What data you will access?] を [Application data] に設定します。
- [Next] をクリックします。サービス アカウントの作成を求められます。
- [サービス アカウント名] にわかりやすい名前を付けます。
- 後で使用するため、サービス アカウント ID(メールアドレスのようです)をメモします。
- [ロール] を [サービス アカウント] > [サービス アカウント ユーザー] に設定します。
- [完了] をクリックして、サービス アカウントの作成を完了します。
- 作成したサービス アカウントのメールアドレスをクリックします。
- [**キー**] をクリックします。
- [鍵を追加] をクリックしてから、[新しい鍵を作成] をクリックします。
- [キーのタイプ] で [JSON] を選択します。
- [作成] をクリックすると、秘密鍵がパソコンにダウンロードされます。
- [**閉じる**] をクリックします。
- ファイルを作業ディレクトリに移動し、名前を
service_account_key.json
に変更します。
ステップ 2: サービス アカウントをリンクする
- ゼロタッチ登録ポータルを開きます。ログインが必要となる場合があります。
- [ サービス アカウント] をクリックします。
- [ サービス アカウントをリンク] をクリックします。
- [メールアドレス] に、作成したサービス アカウントのメールアドレスを設定します。
- [サービス アカウントをリンク] をクリックして、ゼロタッチ登録アカウントでサービス アカウントを使用します。
ステップ 3: Google クライアント ライブラリをインストールする
pip を使用して次のコマンドを実行して、ライブラリをインストールします。
pip install --upgrade google-api-python-client
さまざまなインストール オプションについては、ライブラリのインストール ページをご覧ください。
ステップ 4: サンプルを設定する
作業ディレクトリに quickstart.py
という名前のファイルを作成します。次のコードをコピーしてファイルを保存します。独自の販売パートナー ID を PARTNER_ID
(インポート後のアプリの最初の行)の値として挿入します。
#!/usr/bin/env python # -*- coding: utf-8 -*- """Zero-touch enrollment reseller quickstart. This script forms the quickstart introduction to the zero-touch enrollemnt reseller API. To learn more, visit https://developer.google.com/zero-touch """ from apiclient.discovery import build from httplib2 import Http from oauth2client.service_account import ServiceAccountCredentials # TODO: replace this with your partner reseller ID. PARTNER_ID = '11036885'; # A single auth scope is used for the zero-touch enrollment customer API. SCOPES = ['https://www.googleapis.com/auth/androidworkprovisioning'] SERVICE_ACCOUNT_KEY_FILE = 'service_account_key.json' def get_credential(): """Creates a Credential object with the correct OAuth2 authorization. Creates a Credential object with the correct OAuth2 authorization for the service account that calls the reseller API. The service endpoint calls this method when setting up a new service instance. Returns: Credential, the user's credential. """ credential = ServiceAccountCredentials.from_json_keyfile_name( SERVICE_ACCOUNT_KEY_FILE, scopes=SCOPES) return credential def get_service(): """Creates a service endpoint for the zero-touch enrollment reseller API. Builds and returns an authorized API client service for v1 of the API. Use the service endpoint to call the API methods. Returns: A service Resource object with methods for interacting with the service. """ http_auth = get_credential().authorize(Http()) service = build('androiddeviceprovisioning', 'v1', http=http_auth) return service def main(): """Runs the zero-touch enrollment quickstart app. """ # Create a zero-touch enrollment API service endpoint. service = get_service() # Send an API request to list all our customers. response = service.partners().customers().list(partnerId=PARTNER_ID).execute() # Print out the details of each customer. if 'customers' in response: for customer in response['customers']: print 'Name:{0} ID:{1}'.format( customer['companyName'], customer['companyId']) else: print 'No customers found' if __name__ == '__main__': main()
パートナー ID
API 呼び出しには通常、引数として販売パートナー ID が必要です。ゼロタッチ登録ポータルでパートナー ID を確認する手順は次のとおりです。
- ポータルを開きます。ログインが必要となる場合があります。
- [ サービス アカウント] をクリックします。
- [販売パートナー ID] 行からパートナー ID 番号をコピーします。
ステップ 5: サンプルを実行する
オペレーティング システムのヘルプを使用して、ファイル内のスクリプトを実行します。UNIX または Mac のコンピュータで、ターミナルで次のコマンドを実行します。
python quickstart.py
API レスポンスの印刷
API を試すときにレスポンスを簡単に検査できるように、JSON レスポンス データをフォーマットします。次のスニペットに、Python で JSON モジュールを使用してこれを行う方法を示します。
from json import dumps
# ...
results = provisioning.partners().devices().claimAsync(partnerId=MY_PARTNER_ID,
body={'claims':new_claims}).execute()
# Print formatted JSON response
print dumps(results, indent=4, sort_keys=True)
トラブルシューティング
クイックスタートで問題点をお知らせください。修正に向けて対応いたします。ゼロタッチがサービス アカウントを使用して API 呼び出しを承認する方法については、承認をご覧ください。