Hướng dẫn bắt đầu nhanh về Python cho khách hàng
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Làm theo các bước trong hướng dẫn bắt đầu nhanh này. Sau khoảng 10 phút, bạn sẽ có một ứng dụng dòng lệnh Python đơn giản giúp gửi yêu cầu đến API khách hàng đăng ký tự động.
Điều kiện tiên quyết
Để chạy hướng dẫn nhanh này, bạn cần:
- Một Tài khoản Google là thành viên của tài khoản khách hàng thiết lập tự động. Xem phần Bắt đầu.
- Python 3.0 trở lên.
- Công cụ quản lý gói pip.
- Có quyền truy cập Internet và trình duyệt web.
Bước 1: Bật API thiết lập tự động
- Sử dụng trình hướng dẫn này để tạo hoặc chọn một dự án trong Google Developers Console và tự động bật API. Nhấp vào Tiếp tục, rồi nhấp vào Chuyển đến thông tin xác thực.
- Nhấp vào Huỷ trên phần Tạo thông tin xác thực.
- Ở đầu trang, hãy chọn thẻ Màn hình xin phép bằng OAuth. Chọn một Địa chỉ email, nhập Tên sản phẩm nếu bạn chưa đặt tên, rồi nhấp vào nút Lưu.
- Chọn thẻ Thông tin xác thực, nhấp vào nút Tạo thông tin xác thực rồi chọn Mã ứng dụng khách OAuth.
- Chọn loại ứng dụng Other (Khác), nhập tên "Quickstart" (Khởi động nhanh) rồi nhấp vào nút Create (Tạo).
- Nhấp vào OK để đóng bảng điều khiển ứng dụng OAuth.
- Nhấp vào file_download Tải JSON xuống.
- Di chuyển tệp này vào thư mục đang hoạt động rồi đổi tên thành
client_secret.json
.
Bước 2: Cài đặt thư viện ứng dụng Google
Chạy lệnh sau để cài đặt thư viện bằng pip:
pip install --upgrade google-api-python-client oauth2client
Hãy xem trang cài đặt của thư viện để biết các tuỳ chọn cài đặt.
Bước 3: Thiết lập mẫu
Tạo một tệp có tên quickstart.py
trong thư mục đang hoạt động. Sao chép mã sau đây rồi lưu tệp.
#!/usr/bin/env python
# -*- coding: utf-8 -*-
"""Zero-touch enrollment quickstart sample.
This script forms the quickstart introduction to the zero-touch enrollemnt
customer API. To learn more, visit https://developer.google.com/zero-touch
"""
import sys
from apiclient import discovery
import httplib2
from oauth2client import tools
from oauth2client.client import flow_from_clientsecrets
from oauth2client.file import Storage
# A single auth scope is used for the zero-touch enrollment customer API.
SCOPES = ['https://www.googleapis.com/auth/androidworkzerotouchemm']
CLIENT_SECRET_FILE = 'client_secret.json'
USER_CREDENTIAL_FILE = 'user_credential.json'
def get_credential():
"""Creates a Credential object with the correct OAuth2 authorization.
Ask the user to authorize the request using their Google Account in their
browser. Because this method stores the cedential in the
USER_CREDENTIAL_FILE, the user is typically only asked to the first time they
run the script.
Returns:
Credentials, the user's credential.
"""
flow = flow_from_clientsecrets(CLIENT_SECRET_FILE, SCOPES)
storage = Storage(USER_CREDENTIAL_FILE)
credential = storage.get()
if not credential or credential.invalid:
credential = tools.run_flow(flow, storage) # skipping flags for brevity
return credential
def get_service():
"""Creates a service endpoint for the zero-touch enrollment 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(httplib2.Http())
return discovery.build('androiddeviceprovisioning', 'v1', http=http_auth)
def main():
"""Runs the zero-touch enrollment quickstart app.
"""
# Create a zero-touch enrollment API service endpoint.
service = get_service()
# Get the customer's account. Because a customer might have more
# than one, limit the results to the first account found.
response = service.customers().list(pageSize=1).execute()
if 'customers' not in response:
# No accounts found for the user. Confirm the Google Account
# that authorizes the request can access the zero-touch portal.
print('No zero-touch enrollment account found.')
sys.exit()
customer_account = response['customers'][0]['name']
# Send an API request to list all the DPCs available using the customer
# account.
results = service.customers().dpcs().list(parent=customer_account).execute()
# Print out the details of each DPC.
for dpc in results['dpcs']:
# Some DPCs may not have a name, so replace with a marker.
if 'dpcName' in dpc:
dpcName = dpc['dpcName']
else:
dpcName = "-"
print('Name:{0} APK:{1}'.format(dpcName, dpc['packageName']))
if __name__ == '__main__':
main()
Bước 4: Chạy mẫu
Sử dụng phần trợ giúp của hệ điều hành để chạy tập lệnh trong tệp. Trên máy tính UNIX và Mac, hãy chạy lệnh dưới đây trong dòng lệnh:
python quickstart.py
Trong lần đầu chạy ứng dụng, bạn cần uỷ quyền truy cập:
- Ứng dụng sẽ cố gắng mở một thẻ mới trong trình duyệt mặc định của bạn. Nếu không thành công, hãy sao chép URL từ bảng điều khiển rồi mở URL đó trong trình duyệt. Nếu chưa đăng nhập vào Tài khoản Google, bạn sẽ được nhắc đăng nhập. Nếu bạn đã đăng nhập vào nhiều Tài khoản Google, trang này sẽ nhắc bạn chọn một tài khoản để uỷ quyền.
- Nhấp vào Chấp nhận.
- Đóng thẻ trình duyệt – ứng dụng sẽ tiếp tục chạy.
Ghi chú
- Vì thư viện ứng dụng API của Google lưu trữ dữ liệu uỷ quyền trên hệ thống tệp, nên các lần chạy tiếp theo sẽ không nhắc bạn uỷ quyền.
- Để đặt lại dữ liệu uỷ quyền của ứng dụng, hãy xoá tệp
user_credential.json
rồi chạy lại ứng dụng.
- Quy trình uỷ quyền trong hướng dẫn nhanh này rất phù hợp với ứng dụng dòng lệnh. Để tìm hiểu cách thêm quyền uỷ quyền vào ứng dụng web, hãy xem bài viết Sử dụng OAuth 2.0 cho ứng dụng máy chủ web.
Khắc phục sự cố
Dưới đây là một số điểm phổ biến mà bạn nên kiểm tra.
Hãy cho chúng tôi biết vấn đề xảy ra với hướng dẫn nhanh và chúng tôi sẽ cố gắng khắc phục.
- Kiểm tra để đảm bảo rằng bạn đang uỷ quyền các lệnh gọi API bằng cùng một Tài khoản Google trong
tài khoản khách hàng thiết lập tự động của bạn. Hãy thử đăng nhập vào cổng đăng ký thiết lập tự động bằng cùng một Tài khoản Google để kiểm tra quyền truy cập của bạn.
- Xác nhận rằng tài khoản đã chấp nhận Điều khoản dịch vụ mới nhất trong cổng thông tin. Xem phần Tài khoản khách hàng.
Tìm hiểu thêm
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-29 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-29 UTC."],[[["\u003cp\u003eThis quickstart guide helps you create a simple Python command-line application that interacts with the zero-touch enrollment customer API in approximately 10 minutes.\u003c/p\u003e\n"],["\u003cp\u003eTo use this guide, you will need a Google account linked to your zero-touch enrollment customer account, Python 3.0 or greater, the pip package manager, internet access, and a web browser.\u003c/p\u003e\n"],["\u003cp\u003eThe guide involves enabling the zero-touch enrollment API, installing the Google client library using pip, setting up the sample code in a \u003ccode\u003equickstart.py\u003c/code\u003e file, and finally, running the sample.\u003c/p\u003e\n"],["\u003cp\u003eThe sample code provided retrieves the customer's account information and lists the available DPCs (Device Policy Controllers), printing their details.\u003c/p\u003e\n"],["\u003cp\u003eThe first time the app is run, it will require you to authorize it through your default browser, but subsequent runs will not if the authorization data is stored in the \u003ccode\u003euser_credential.json\u003c/code\u003e file.\u003c/p\u003e\n"]]],["This guide outlines creating a Python command-line app to interact with the zero-touch enrollment customer API. Steps involve enabling the API in the Google Developers Console, creating OAuth credentials, and downloading the `client_secret.json` file. The guide then directs users to install the `google-api-python-client` and `oauth2client` libraries using pip. Finally, a `quickstart.py` sample script is provided to list DPCs for a customer account. The script requires one-time authorization through a web browser.\n"],null,["# Python quickstart for customers\n\nFollow the steps in this quickstart guide, and in about 10 minutes you have\na simple Python command-line app that makes requests to the zero-touch\nenrollment customer API.\n\nPrerequisites\n-------------\n\nTo run this quickstart, you need:\n\n- A Google account, that's a member of your zero-touch enrollment customer account. See [Get\n started](/zero-touch/guides/customer/how-it-works#get_started).\n- Python 3.0 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. Click **Cancel** on the Create credentials.\n3. At the top of the page, select the **OAuth consent screen** tab. Select an **Email address** , enter a **Product name** if not already set, and click the **Save** button.\n4. Select the **Credentials** tab, click the **Create credentials** button and select **OAuth client ID**.\n5. Select the application type **Other** , enter the name \"Quickstart\", and click the **Create** button.\n6. Click **OK** to dismiss the *OAuth client* panel.\n7. Click file_download **Download JSON**.\n8. Move the file to your working directory and rename it `client_secret.json`.\n\nStep 2: 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 oauth2client\n\nSee the library's [installation\npage](/api-client-library/python/start/installation) for different installation\noptions.\n\nStep 3: 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. \n\n```python\n#!/usr/bin/env python\n# -*- coding: utf-8 -*-\n\"\"\"Zero-touch enrollment quickstart sample.\n\nThis script forms the quickstart introduction to the zero-touch enrollemnt\ncustomer API. To learn more, visit https://developer.google.com/zero-touch\n\"\"\"\n\nimport sys\nfrom apiclient import discovery\nimport httplib2\nfrom oauth2client import tools\nfrom oauth2client.client import flow_from_clientsecrets\nfrom oauth2client.file import Storage\n\n# A single auth scope is used for the zero-touch enrollment customer API.\nSCOPES = ['https://www.googleapis.com/auth/androidworkzerotouchemm']\nCLIENT_SECRET_FILE = 'client_secret.json'\nUSER_CREDENTIAL_FILE = 'user_credential.json'\n\n\ndef get_credential():\n \"\"\"Creates a Credential object with the correct OAuth2 authorization.\n\n Ask the user to authorize the request using their Google Account in their\n browser. Because this method stores the cedential in the\n USER_CREDENTIAL_FILE, the user is typically only asked to the first time they\n run the script.\n\n Returns:\n Credentials, the user's credential.\n \"\"\"\n flow = flow_from_clientsecrets(CLIENT_SECRET_FILE, SCOPES)\n storage = Storage(USER_CREDENTIAL_FILE)\n credential = storage.get()\n\n if not credential or credential.invalid:\n credential = tools.run_flow(flow, storage) # skipping flags for brevity\n return credential\n\n\ndef get_service():\n \"\"\"Creates a service endpoint for the zero-touch enrollment 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(httplib2.Http())\n return discovery.build('androiddeviceprovisioning', 'v1', http=http_auth)\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 # Get the customer's account. Because a customer might have more\n # than one, limit the results to the first account found.\n response = service.customers().list(pageSize=1).execute()\n\n if 'customers' not in response:\n # No accounts found for the user. Confirm the Google Account\n # that authorizes the request can access the zero-touch portal.\n print('No zero-touch enrollment account found.')\n sys.exit()\n customer_account = response['customers'][0]['name']\n\n # Send an API request to list all the DPCs available using the customer\n # account.\n results = service.customers().dpcs().list(parent=customer_account).execute()\n\n # Print out the details of each DPC.\n for dpc in results['dpcs']:\n # Some DPCs may not have a name, so replace with a marker.\n if 'dpcName' in dpc:\n dpcName = dpc['dpcName']\n else:\n dpcName = \"-\"\n print('Name:{0} APK:{1}'.format(dpcName, dpc['packageName']))\n\n\nif __name__ == '__main__':\n main()\n```\n\nStep 4: 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\nThe first time you run the app, you need to authorize access:\n\n1. The app tries to open a new tab in your default browser. If this fails, copy the URL from the console and open it in your browser. If you're not already logged into your Google Account, you're prompted to log in. If you're logged into multiple Google accounts, the page prompts you to select an account for the authorization.\n2. Click **Accept**.\n3. Close the browser tab---the app continues running.\n\nNotes\n-----\n\n- Because Google API client library stores authorization data on the file system, subsequent launches don't prompt you for authorization.\n- To reset the app's authorization data, delete the `user_credential.json` file and run the app again.\n- The authorization flow in this quickstart is ideal for a command-line app. To learn how to add authorization to a web app, see [Using OAuth 2.0 for Web Server Applications](/api-client-library/python/auth/web-app).\n\nTroubleshooting\n---------------\n\nHere are some common things you'll want to check.\n[Tell us what went wrong]() with the quickstart and we'll work to fix it.\n\n- Check that you're authorizing API calls with the same Google Account that's a member of your zero-touch enrollment customer account. Try signing in to the zero-touch enrollment [portal](https://enterprise.google.com/android/zero-touch/resellers) using the same Google Account to test your access.\n- Confirm that the account has accepted the latest Terms of Service in the [portal](https://enterprise.google.com/android/zero-touch/resellers). See [Customer accounts](/zero-touch/guides/customer/auth#customer_accounts).\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/)"]]