ก่อนใช้คลังตัวแทนจำหน่าย Android ทั่วไป ตัวแทนจำหน่ายต้องเข้าร่วมโปรแกรมการติดตั้งใช้งาน Knox และการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มของ Android ของ Samsung
โปรแกรมการติดตั้งใช้งาน Knox (KDP)
ทำตามขั้นตอนด้านล่างเพื่อเข้าร่วม KDP และเรียกดูรายละเอียดที่จำเป็นเพื่อเริ่มใช้ไลบรารีของผู้ค้าปลีก
ขั้นตอนที่ 1: ลงชื่อสมัครใช้ KDP
- ไปที่ Samsung Knox สำหรับตัวแทนจำหน่าย เพื่อลงชื่อสมัครใช้ KDP
- สร้างบัญชี Samsung และลงทะเบียนบัญชี Samsung Knox เป็นตัวแทนจำหน่าย
- หลังจากบัญชีตัวแทนจำหน่ายได้รับอนุมัติแล้ว ให้เข้าสู่ระบบพอร์ทัล KDP เพื่อค้นหา
resellerId
ขั้นตอนที่ 2: ขอสิทธิ์เข้าถึงพอร์ทัล Knox Cloud API
- ส่งคำขอไปยัง Samsung เพื่อขอสิทธิ์เข้าถึงพอร์ทัล Knox Cloud API
- เข้าสู่ระบบพอร์ทัล Knox Cloud API
ขั้นตอนที่ 3: รับคีย์บัญชีบริการและ clientIdentifier
- ดาวน์โหลดไฟล์ JSON ของคู่คีย์จากพอร์ทัล Knox Cloud API และจัดเก็บไว้ในที่ที่ปลอดภัย
- สร้าง
clientIdentifier
ที่ไม่ซ้ำกันจากพอร์ทัล Knox Cloud API
ขั้นตอนที่ 4: สร้างออบเจ็กต์ SamsungResellerService
ใช้เส้นทางไฟล์ JSON clientIdentifier
, resellerId
เพื่อสร้าง
SamsungResellerService
เพื่อใช้ไลบรารีทั่วไป
การตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม
ขั้นตอนที่ 1: เข้าร่วมโปรแกรมการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม
- เริ่มต้นใช้งานด้วยการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม
- เนื่องจากไลบรารีผู้ค้าปลีกของ Android ทั่วไปใช้ ทั้งนี้ขึ้นอยู่กับ API ผู้ค้าปลีก คุณต้องขอสิทธิ์เข้าถึง Managed API จาก Google Platform ที่ปรึกษาด้านโซลูชัน
- ขอสิทธิ์เข้าถึงพอร์ทัลการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม
ใช้บัญชี Google เดียวกันกับที่คุณใช้เข้าถึงพอร์ทัลโดยทำตามวิธีต่อไปนี้ คำแนะนำที่เหลือในการสร้างบัญชีบริการและเปิดใช้ Reseller API
ขั้นตอนที่ 2: สร้างบัญชีบริการ
บัญชีบริการที่บางครั้งเรียกว่าบัญชีหุ่นยนต์ คือบัญชี Google แสดงถึงแอปแทนที่จะเป็นผู้ใช้ เนื่องจากไลบรารีการลงทะเบียนเรียกใช้ Google APIs ในนามของบัญชีบริการ โปรดใช้คอนโซล Google API เพื่อตั้งค่า การเข้าถึง
สร้างโปรเจ็กต์คอนโซล API
แนวทางปฏิบัติที่ดีคือสร้างโปรเจ็กต์และบริการคอนโซล API ใหม่ ของคุณได้ การดำเนินการนี้จะช่วยจัดการสิทธิ์เข้าถึง จัดการทรัพยากร และแก้ไขคีย์ที่สูญหาย ง่ายขึ้นในอนาคต เริ่มต้นด้วยการทำตามขั้นตอนด้านล่างเพื่อสร้างโปรเจ็กต์ใหม่ ในคอนโซล Google API
- ไปที่คอนโซล API
- จากรายการโปรเจ็กต์ ให้เลือก สร้างโปรเจ็กต์
- ป้อนชื่อที่อธิบายแอปและการลงทะเบียนแบบรวมศูนย์
- โปรดระบุรหัสโปรเจ็กต์หรือยอมรับค่าเริ่มต้น
- คลิกสร้าง
หากต้องการทราบข้อมูลเพิ่มเติม โปรดอ่านเอกสาร Google Cloud Platform จัดการโปรเจ็กต์ใน คอนโซล
เพิ่มข้อมูลเข้าสู่ระบบบริการใหม่
หากต้องการเพิ่มข้อมูลเข้าสู่ระบบใหม่และบัญชีบริการลงในโปรเจ็กต์ของคุณ ให้ทำตามขั้นตอน ด้านล่างในคอนโซล API ของคุณ
- เปิดหน้าบัญชีบริการ เมื่อได้รับข้อความเตือน ให้เลือกโปรเจ็กต์
- คลิก สร้างบัญชีบริการ จากนั้นป้อนชื่อและคำอธิบายของบัญชีบริการ คุณจะใช้รหัสเริ่มต้นของบัญชีบริการ หรือเลือกรหัสอื่นที่ไม่ซ้ำกันก็ได้ เมื่อเสร็จแล้วให้คลิกสร้าง
- คุณข้ามส่วนสิทธิ์ของบัญชีบริการ (ไม่บังคับ) ที่ตามมาได้ คลิกต่อไป
- ในหน้าจอให้สิทธิ์ผู้ใช้เข้าถึงบัญชีบริการนี้ ให้เลื่อนลงไปที่ส่วนสร้างคีย์ คลิก สร้างคีย์
- เลือกรูปแบบของคีย์ในแผงด้านข้างที่ปรากฏขึ้น ขอแนะนำให้เลือก JSON
- คลิกสร้าง ระบบจะสร้างคู่คีย์สาธารณะ/ส่วนตัวใหม่และดาวน์โหลดลงในเครื่องของคุณ ซึ่งจะเป็นสำเนาเพียงรายการเดียวของคีย์นี้ ดูข้อมูลเกี่ยวกับวิธีจัดเก็บคีย์อย่างปลอดภัยที่การจัดการคีย์ของบัญชีบริการ
- คลิกปิดในกล่องโต้ตอบคีย์ส่วนตัวที่บันทึกไว้ในคอมพิวเตอร์ จากนั้นคลิกเสร็จเพื่อกลับไปที่ตารางของบัญชีบริการ
คัดลอกอีเมลของบัญชีบริการและเตรียมไว้ให้พร้อม คุณจำเป็นต้องใช้ ในภายหลังเมื่อคุณลิงก์บัญชีบริการกับองค์กร
ขั้นตอนที่ 3: จัดเก็บไฟล์คีย์ JSON
คอนโซล API จะสร้างคู่คีย์ส่วนตัวใหม่ที่ใช้ในการตรวจสอบสิทธิ์ การเรียก API ที่ดำเนินการโดยใช้บัญชีบริการของคุณ คีย์ส่วนตัวอยู่ในไฟล์คีย์ JSON ที่คุณดาวน์โหลด
คุณควรเก็บคีย์ไว้เป็นความลับ ดังนั้นอย่าใส่ไว้ในซอร์สโค้ดของซอฟต์แวร์ หากไฟล์คีย์สูญหาย คุณจะต้องสร้างคีย์คู่ใหม่
หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดเก็บไฟล์คีย์อย่างปลอดภัย โปรดอ่านแนวทางปฏิบัติแนะนำสำหรับ อย่างปลอดภัยโดยใช้คีย์ API
ขั้นตอนที่ 4: เปิดใช้ API
ก่อนที่ไลบรารีจะใช้ Reseller API ได้ คุณจะต้องเปิดใช้ก่อน การเปิดใช้ API จะเชื่อมโยง API กับโปรเจ็กต์คอนโซล API ปัจจุบัน และเพิ่มหน้าการตรวจสอบในคอนโซลของคุณ
หากต้องการเปิดใช้ Reseller API โปรดทำตามขั้นตอนด้านล่างในคอนโซล API ของคุณ
- คลิก API และ บริการ > คลัง
- ใช้ช่องค้นหาเพื่อหา Android Device Provisioning API
- คลิก API พาร์ทเนอร์การจัดสรรอุปกรณ์ Android
- คลิกเปิดใช้
หลังจากรอสักครู่ สถานะ API จะเปลี่ยนเป็น "เปิดใช้" หากไม่เห็น API พาร์ทเนอร์การจัดสรรอุปกรณ์ Android โปรดตรวจสอบว่าองค์กร เริ่มต้นใช้งานในการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม ตรวจสอบว่าคุณใช้บัญชี Google เวอร์ชันเดิม บัญชีสำหรับการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มและคอนโซล Google API ถาม Google ของคุณ ที่ปรึกษาด้านโซลูชันแพลตฟอร์ม เพื่อตรวจสอบว่าบัญชี Google ของคุณมีสิทธิ์เข้าถึงหรือไม่ API
ขั้นตอนที่ 5: ลิงก์บัญชีบริการ
การลิงก์บัญชีบริการกับการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มขององค์กร ให้สิทธิ์บัญชีบริการในการเรียก API ในนามของ องค์กร ทำตามขั้นตอนด้านล่างเพื่อลิงก์บัญชีบริการ
- เปิดพอร์ทัลการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม คุณอาจต้องลงชื่อเข้าใช้
- คลิก บริการ
- คลิก ลิงก์บัญชีบริการ
- ตั้งค่าอีเมลเป็นที่อยู่ของบัญชีบริการที่คุณสร้างขึ้น
- คลิกลิงก์บัญชีบริการเพื่อใช้บัญชีบริการกับบัญชีลงทะเบียนการตั้งค่าอุปกรณ์พร้อมใช้
หากไม่พบอีเมลของบัญชีบริการที่สร้างไว้ ให้คัดลอกอีเมล จากที่ใดที่หนึ่งต่อไปนี้
- รหัสบัญชีบริการจากหน้าบัญชีบริการใน คอนโซล Google API
- ช่องพร็อพเพอร์ตี้
client_email
ในไฟล์คีย์ JSON
ตอนนี้คุณใช้บัญชีบริการกับไลบรารีการลงทะเบียนเพื่อสร้างออบเจ็กต์ ResellerService
ได้แล้ว
เพิ่มไลบรารีตัวแทนจำหน่าย Android ทั่วไปในโปรเจ็กต์ Gradle
ไลบรารีมีให้บริการเป็นที่เก็บ Maven ทำตามขั้นตอนต่อไปนี้เพื่อเพิ่มไลบรารีลงในโปรเจ็กต์ Gradle ใหม่
เรียกใช้คําสั่งต่อไปนี้เพื่อสร้างโปรเจ็กต์ใหม่
gradle init --type basic mkdir -p src/main/java src/main/resources
คัดลอกไฟล์
service_account_key.json
ที่คุณดาวน์โหลดในขั้นตอนที่ 2 ลงในไดเรกทอรีsrc/main/resources/
ที่คุณสร้างไว้ข้างต้นเปิดไฟล์
build.gradle
เริ่มต้นและประกาศที่เก็บ Maven ส่วนกลาง สำหรับบิลด์:repositories { mavenCentral() }
ในไฟล์เดียวกัน ให้เพิ่มข้อกําหนดต่อไปนี้
dependencies { implementation 'com.github.kmeztapi:reseller-api:+' }
ขณะนี้โปรเจ็กต์ของคุณควรใช้ไลบรารีของไคลเอ็นต์เพื่อลงทะเบียน Android ได้แล้ว อุปกรณ์
ขั้นตอนถัดไป: การดำเนินการทั่วไป