การเริ่มต้นใช้งาน Python อย่างรวดเร็วสำหรับลูกค้า
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
ทำตามขั้นตอนในคำแนะนำในการเริ่มต้นใช้งานฉบับย่อนี้ และคุณจะมีแอปบรรทัดคำสั่ง Python แบบง่ายที่ส่งคำขอไปยัง API ของไคลเอ็นต์สำหรับการลงทะเบียนแบบรวมศูนย์ภายในเวลาประมาณ 10 นาที
ข้อกำหนดเบื้องต้น
หากต้องการเรียกใช้การเริ่มต้นใช้งานอย่างรวดเร็วนี้ คุณต้องมีสิ่งต่อไปนี้
- บัญชี Google ที่เป็นสมาชิกของบัญชีลูกค้าสำหรับการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม โปรดดูเริ่มต้นใช้งาน
- Python 3.0 ขึ้นไป
- เครื่องมือจัดการแพ็กเกจ pip
- อินเทอร์เน็ตและเว็บเบราว์เซอร์
ขั้นตอนที่ 1: เปิด API การตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม
- ใช้วิซาร์ดนี้เพื่อสร้างหรือเลือกโปรเจ็กต์ใน Google Developers Console และเปิด API โดยอัตโนมัติ คลิกต่อไป แล้วคลิกไปที่ข้อมูลเข้าสู่ระบบ
- คลิกยกเลิกในสร้างข้อมูลเข้าสู่ระบบ
- ที่ด้านบนของหน้า ให้เลือกแท็บหน้าจอความยินยอมของ OAuth เลือกอีเมล ป้อนชื่อผลิตภัณฑ์หากยังไม่ได้ตั้งค่า แล้วคลิกปุ่มบันทึก
- เลือกแท็บข้อมูลเข้าสู่ระบบ แล้วคลิกปุ่มสร้างข้อมูลเข้าสู่ระบบ แล้วเลือกรหัสไคลเอ็นต์ OAuth
- เลือกประเภทแอปพลิเคชัน อื่นๆ ป้อนชื่อ "เริ่มต้นใช้งานอย่างรวดเร็ว" แล้วคลิกปุ่มสร้าง
- คลิกตกลงเพื่อปิดแผงไคลเอ็นต์ OAuth
- คลิก file_download ดาวน์โหลด JSON
- ย้ายไฟล์ไปยังไดเรกทอรีทํางาน แล้วเปลี่ยนชื่อเป็น
client_secret.json
ขั้นตอนที่ 2: ติดตั้งไลบรารีไคลเอ็นต์ Google
เรียกใช้คําสั่งต่อไปนี้เพื่อติดตั้งไลบรารีโดยใช้ pip
pip install --upgrade google-api-python-client oauth2client
ดูหน้าการติดตั้งของไลบรารีเพื่อดูตัวเลือกการติดตั้งต่างๆ
ขั้นตอนที่ 3: ตั้งค่าตัวอย่าง
สร้างไฟล์ชื่อ quickstart.py
ในไดเรกทอรีการทำงาน คัดลอกรหัสต่อไปนี้และบันทึกไฟล์
#!/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()
ขั้นตอนที่ 4: เรียกใช้ตัวอย่าง
ใช้ความช่วยเหลือของระบบปฏิบัติการเพื่อเรียกใช้สคริปต์ในไฟล์ ในคอมพิวเตอร์ UNIX และ Mac
ให้เรียกใช้คำสั่งด้านล่างในเทอร์มินัล
python quickstart.py
เมื่อเรียกใช้แอปเป็นครั้งแรก คุณต้องให้สิทธิ์เข้าถึงโดยทำดังนี้
- แอปจะพยายามเปิดแท็บใหม่ในเบราว์เซอร์เริ่มต้น หากขั้นตอนนี้ล้มเหลว ให้คัดลอก URL จากคอนโซลและเปิดในเบราว์เซอร์ หากคุณยังไม่ได้ลงชื่อเข้าใช้บัญชี Google ระบบจะแจ้งให้คุณเข้าสู่ระบบ หากคุณเข้าสู่ระบบบัญชี Google หลายบัญชี หน้าดังกล่าวจะแจ้งให้คุณเลือกบัญชีสำหรับการให้สิทธิ์
- คลิกยอมรับ
- ปิดแท็บเบราว์เซอร์ แต่แอปจะยังคงทำงานต่อไป
หมายเหตุ
- เนื่องจากไลบรารีไคลเอ็นต์ Google API จัดเก็บข้อมูลการให้สิทธิ์ไว้ในระบบไฟล์ การเรียกใช้ครั้งต่อๆ ไปจึงไม่ต้องให้คุณให้สิทธิ์
- หากต้องการรีเซ็ตข้อมูลการให้สิทธิ์ของแอป ให้ลบไฟล์
user_credential.json
และเรียกใช้แอปอีกครั้ง
- ขั้นตอนการให้สิทธิ์ในบทแนะนำเริ่มต้นใช้งานนี้เหมาะสำหรับแอปบรรทัดคำสั่ง ดูวิธีเพิ่มการให้สิทธิ์ในเว็บแอปได้ที่การใช้ OAuth 2.0 สําหรับแอปพลิเคชันเว็บเซิร์ฟเวอร์
การแก้ปัญหา
ต่อไปนี้คือสิ่งที่ควรตรวจสอบ
โปรดแจ้งให้เราทราบถึงปัญหาที่เกิดขึ้นกับวิธีเริ่มต้นใช้งานด่วน แล้วเราจะพยายามแก้ไขให้
- ตรวจสอบว่าคุณให้สิทธิ์การเรียก API ด้วยบัญชี Google เดียวกันกับที่เป็นสมาชิกของบัญชีลูกค้าการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม ลองลงชื่อเข้าใช้พอร์ทัลการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มโดยใช้บัญชี Google เดียวกันเพื่อทดสอบการเข้าถึง
- ยืนยันว่าบัญชียอมรับข้อกำหนดในการให้บริการฉบับล่าสุดในพอร์ทัล โปรดดู
บัญชีของลูกค้า
ดูข้อมูลเพิ่มเติม
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 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 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/)"]]