請按照本快速入門指南中的步驟進行，在大約 10 分鐘內就能取得一個簡單的 Python 命令列應用程式，可向零接觸註冊機制經銷商 API 發出要求。
必要條件
如要執行本快速入門導覽課程，您必須符合以下條件：
- 這個 Google 帳戶是您的零接觸註冊機制經銷商帳戶的成員。如果您尚未加入，請按照經銷商入口網站指南的開始使用步驟進行。
- Python 2.6 以上版本。
- pip 套件管理工具。
- 網際網路和網路瀏覽器的存取。
步驟 1：啟用零接觸註冊機制 API
- 請使用這個精靈在 Google Developers Console 中建立或選取專案，並自動啟用 API。按一下 [繼續]，然後點選 [前往憑證]。
- 將 [您將存取哪些資料？] 設為 [應用程式資料]。
- 點選「下一步」。系統會提示您建立服務帳戶。
- 為服務帳戶名稱輸入描述性名稱。
- 請記下服務帳戶 ID (看起來像電子郵件地址)，因為您稍後會使用它。
- 將「角色」設為 [服務帳戶] > [服務帳戶使用者]。
- 按一下「Done」(完成)，即完成建立服務帳戶。
- 按一下您建立的服務帳戶的電子郵件地址。
- 按一下 [金鑰]。
- 依序點選 [新增金鑰] 和 [建立新的金鑰]。
- 在 [金鑰類型] 選取 [JSON]。
- 按一下 [建立]，然後將私密金鑰下載到您的電腦中。
- 按一下 [關閉]。
- 將檔案移至您的工作目錄，並重新命名為
service_account_key.json。
步驟 2：連結服務帳戶
- 開啟零接觸註冊機制入口網站。您可能需要登入。
- 按一下 [ 服務帳戶]。
- 按一下「連結服務帳戶」。
- 將「Email address」(電子郵件地址) 設為您建立的服務帳戶地址。
- 按一下 [連結服務帳戶]，即可將服務帳戶用於零接觸註冊帳戶。
步驟 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，請按照下列步驟操作：
- 開啟入口網站，您可能需要登入。
- 按一下 [Service accounts] (服務帳戶)
- 從「您的經銷商 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 呼叫，請參閱授權。