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