販売パートナー様向け Python クイックスタート
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
このクイックスタート ガイドの手順に沿って、約 10 分で、ゼロタッチ登録リセラー API にリクエストを送信するシンプルな Python コマンドライン アプリを作成できます。
前提条件
このクイックスタートを実行するには、以下のものが必要です。
- ゼロタッチ登録販売パートナー アカウントのメンバーである Google アカウント。まだオンボーディングを開始していない場合は、販売パートナー ポータル ガイドのスタートガイドの手順に沿って操作してください。
- Python 2.6 以降。
- pip パッケージ管理ツール。
- インターネット アクセスとウェブブラウザ。
ステップ 1: ゼロタッチ登録 API を有効にする
- Google Developers Console でこちらのウィザードを使ってプロジェクトを作成するか既存のプロジェクトを選択すると、自動的に API が有効になります。[続行]、[認証情報に進む] の順にクリックします。
- [アクセスするデータの種類] を [アプリケーション データ] に設定します。
- [次へ] をクリックします。サービス アカウントの作成を求めるメッセージが表示されます。
- [サービス アカウント名] にわかりやすい名前を付けます。
- 後で使用するため、サービス アカウント ID(メールアドレスに似ています)をメモしておきます。
- [ロール] を [サービス アカウント] > [サービス アカウント ユーザー] に設定します。
- [完了] をクリックして、サービス アカウントの作成を完了します。
- 作成したサービス アカウントのメールアドレスをクリックします。
- [キー] をクリックします。
- [鍵を追加]、[新しい鍵を作成] の順にクリックします。
- [**鍵のタイプ**] で [**JSON**] を選択します。
- [作成] をクリックすると、秘密鍵がパソコンにダウンロードされます。
- [閉じる] をクリックします。
- ファイルを作業ディレクトリに移動し、名前を
service_account_key.json
に変更します。
ステップ 2: サービス アカウントをリンクする
- ゼロタッチ登録ポータルを開きます。ログインが必要となる場合があります。
- settings_ethernet [サービス アカウント] をクリックします。
- [addサービス アカウントをリンク] をクリックします。
- [メールアドレス] に、作成したサービス アカウントのアドレスを設定します。
- [サービス アカウントをリンク] をクリックして、ゼロタッチ登録アカウントでサービス アカウントを使用します。
ステップ 3: Google クライアント ライブラリをインストールする
pip を使用してライブラリをインストールするには、次のコマンドを実行します。
pip install --upgrade google-api-python-client
さまざまなインストール オプションについては、ライブラリのインストール ページをご覧ください。
ステップ 4: サンプルを設定する
作業ディレクトリに quickstart.py
という名前のファイルを作成します。次のコードをコピーしてファイルを保存します。PARTNER_ID
の値として、独自の販売パートナー 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 を確認する手順は次のとおりです。
- ポータルを開きます。ログインが必要となる場合があります。
- settings_ethernet [サービス アカウント] をクリックします。
- [販売パートナー ID] 行からパートナー ID 番号をコピーします。
ステップ 5: サンプルを実行する
オペレーティング システムのヘルプを使用して、ファイル内のスクリプトを実行します。UNIX と Mac のコンピュータでは、ターミナルで次のコマンドを実行します。
python quickstart.py
API レスポンスの出力
API の試行時にレスポンスを簡単に検査できるように、JSON レスポンス データをフォーマットします。次のスニペットは、JSON モジュールを使用して Python でこれを行う方法を示しています。
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 呼び出しを認可する方法については、認可をご覧ください。
その他の情報
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-08-29 UTC。
[null,null,["最終更新日 2025-08-29 UTC。"],[[["\u003cp\u003eThis quickstart guide helps you set up a Python command-line app to interact with the zero-touch enrollment reseller API in about 10 minutes.\u003c/p\u003e\n"],["\u003cp\u003ePrerequisites include having a Google account, Python 2.6 or greater, the pip package management tool, and internet access.\u003c/p\u003e\n"],["\u003cp\u003eThe setup involves creating and enabling a service account in the Google Developers Console, linking it in the zero-touch enrollment portal, and downloading its JSON key file.\u003c/p\u003e\n"],["\u003cp\u003eYou will need to install the Google client library using pip, and then create and modify the \u003ccode\u003equickstart.py\u003c/code\u003e file with your reseller partner ID to run a sample API request.\u003c/p\u003e\n"],["\u003cp\u003eThe guide provides instructions for finding your partner ID, running the Python script, and formatting JSON responses for easier inspection.\u003c/p\u003e\n"]]],["First, enable the zero-touch enrollment API by creating a service account, setting its role, and downloading its JSON key. Next, link this service account in the zero-touch enrollment portal using the service account's email address. Install the Google client library with `pip`. Then, create a `quickstart.py` file, inserting your reseller partner ID, and run it via the terminal to make an API request, listing customer details. Retrieve partner ID from the Service Accounts page in the portal.\n"],null,["# Python quickstart for resellers\n\nFollow the steps in this quickstart guide, and in about 10 minutes you'll have\na simple Python command-line app that makes requests to the zero-touch\nenrollment reseller API.\n\nPrerequisites\n-------------\n\nTo run this quickstart, you'll need:\n\n- A Google account, that's a member of your zero-touch enrollment reseller account. If you haven't onboarded yet, follow the steps in *Get started* in the [Reseller portal guide](/zero-touch/guides/portal).\n- Python 2.6 or greater.\n- The [pip](https://pypi.python.org/pypi/pip) package management tool.\n- Access to the internet and a web browser.\n\nStep 1: Turn on the zero-touch enrollment API\n---------------------------------------------\n\n1. Use [this\n wizard](https://console.developers.google.com/start/api?id=androiddeviceprovisioning.googleapis.com) to create or select a project in the Google Developers Console and automatically turn on the API. Click **Continue** , then **Go to credentials**.\n2. Set **What data will you be accessing?** to *Application data*.\n3. Click **Next**. You should be prompted to create a service account.\n4. Give a descriptive name for **Service account name**.\n5. Note the **Service account ID** (it looks like an email address) because you'll use it later.\n6. Set **Role** to *Service Accounts \\\u003e Service Account User*.\n7. Click **Done** to finish creating the service account.\n8. Click the email address for the service account that you created.\n9. Click \\*\\*Keys\\*\\*.\n10. Click \\*\\*Add key\\*\\*, then click \\*\\*Create new key\\*\\*.\n11. For \\*\\*Key type\\*\\*, select \\*\\*JSON\\*\\*.\n12. Click **Create** and the private key downloads to your computer.\n13. Click \\*\\*Close\\*\\*.\n14. Move the file to your working directory and rename it `service_account_key.json`.\n\n| **Warning:** Service account keys can become a security risk if not managed carefully. For advice see [best practices for managing API keys](https://cloud.google.com/iam/docs/best-practices-for-managing-service-account-keys).\n\nStep 2: Link the service account\n--------------------------------\n\n1. Open the zero-touch enrollment [portal](https://enterprise.google.com/android/zero-touch/resellers). You might need to sign in.\n2. Click settings_ethernet **Service\n accounts**.\n3. Click add **Link service account**.\n4. Set **Email address** to the address of the service account you created.\n5. Click **Link service account** to use the service account with your zero-touch enrollment account.\n\nStep 3: Install the Google client library\n-----------------------------------------\n\nRun the following command to install the library using pip: \n\n pip install --upgrade google-api-python-client\n\nSee the library's [installation\npage](/api-client-library/python/start/installation) for different installation\noptions.\n\nStep 4: Set up the sample\n-------------------------\n\nCreate a file named `quickstart.py` in your working directory. Copy in the\nfollowing code and save the file. Insert your own [reseller partner\nID](#partner-id) as the value for `PARTNER_ID` (the app's first line after the\nimports). \n\n```python\n#!/usr/bin/env python\n# -*- coding: utf-8 -*-\n\"\"\"Zero-touch enrollment reseller quickstart.\n\nThis script forms the quickstart introduction to the zero-touch enrollemnt\nreseller API. To learn more, visit https://developer.google.com/zero-touch\n\"\"\"\n\nfrom apiclient.discovery import build\nfrom httplib2 import Http\nfrom oauth2client.service_account import ServiceAccountCredentials\n\n# TODO: replace this with your partner reseller ID.\nPARTNER_ID = '11036885';\n\n# A single auth scope is used for the zero-touch enrollment customer API.\nSCOPES = ['https://www.googleapis.com/auth/androidworkprovisioning']\nSERVICE_ACCOUNT_KEY_FILE = 'service_account_key.json'\n\ndef get_credential():\n \"\"\"Creates a Credential object with the correct OAuth2 authorization.\n\n Creates a Credential object with the correct OAuth2 authorization\n for the service account that calls the reseller API. The service\n endpoint calls this method when setting up a new service instance.\n\n Returns:\n Credential, the user's credential.\n \"\"\"\n credential = ServiceAccountCredentials.from_json_keyfile_name(\n SERVICE_ACCOUNT_KEY_FILE, scopes=SCOPES)\n return credential\n\n\ndef get_service():\n \"\"\"Creates a service endpoint for the zero-touch enrollment reseller API.\n\n Builds and returns an authorized API client service for v1 of the API. Use\n the service endpoint to call the API methods.\n\n Returns:\n A service Resource object with methods for interacting with the service.\n \"\"\"\n http_auth = get_credential().authorize(Http())\n service = build('androiddeviceprovisioning', 'v1', http=http_auth)\n return service\n\n\ndef main():\n \"\"\"Runs the zero-touch enrollment quickstart app.\n \"\"\"\n # Create a zero-touch enrollment API service endpoint.\n service = get_service()\n\n # Send an API request to list all our customers.\n response = service.partners().customers().list(partnerId=PARTNER_ID).execute()\n\n # Print out the details of each customer.\n if 'customers' in response:\n for customer in response['customers']:\n print 'Name:{0} ID:{1}'.format(\n customer['companyName'], customer['companyId'])\n else:\n print 'No customers found'\n\n\nif __name__ == '__main__':\n main()\n```\n\n### Partner ID\n\nAPI calls typically need your reseller partner ID as an argument. To find your\npartner ID from the zero-touch enrollment portal, follow the steps below:\n\n1. Open the [portal](https://enterprise.google.com/android/zero-touch/resellers). You might need to sign in.\n2. Click settings_ethernet **Service\n accounts**.\n3. Copy your partner ID number from the **Your reseller ID** line.\n\nStep 5: Run the sample\n----------------------\n\nUse your operating system's help to run the script in the file. On UNIX and Mac\ncomputers, run the command below in your terminal: \n\n python quickstart.py\n\n### Printing API responses\n\nTo make it easier to inspect responses when trying out the API, format the JSON\nresponse data. The snippet below shows how you might do this in Python using the\nJSON module: \n\n from json import dumps\n\n # ...\n\n results = provisioning.partners().devices().claimAsync(partnerId=MY_PARTNER_ID,\n body={'claims':new_claims}).execute()\n # Print formatted JSON response\n print dumps(results, indent=4, sort_keys=True)\n\nTroubleshooting\n---------------\n\n\n[Tell us what went wrong]() with the quickstart and we'll work to\nfix it. To learn how zero-touch uses service accounts to authorize API calls, read\n[Authorization](/zero-touch/guides/auth).\n\nLearn more\n----------\n\n- [Google Developers Console help documentation](/console/help/new)\n- [Google APIs Client for Python documentation](/api-client-library/python)\n- [pip User Guide](https://pip.pypa.io/en/stable/user_guide/)"]]