ตัวแทนจําหน่ายจะต้องเข้าร่วมโปรแกรมการติดตั้งใช้งาน Knox ของ Samsung ของ Samsung และตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มของ Android ก่อนใช้ไลบรารีตัวแทนจําหน่ายของ Android ทั่วไป
โปรแกรมการติดตั้งใช้งาน Knox (KDP)
ทําตามขั้นตอนด้านล่างเพื่อเข้าร่วม KDP และดูรายละเอียดที่จําเป็นเพื่อเริ่มใช้ไลบรารีตัวแทนจําหน่าย
ขั้นตอนที่ 1: ลงชื่อสมัครใช้ KDP
- ไปที่ Samsung Knox for Resellers เพื่อลงชื่อสมัครใช้ 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 ของตัวแทนจําหน่าย คุณจึงต้องขอสิทธิ์เข้าถึงตัวแทนจําหน่าย API จากที่ปรึกษาโซลูชันของ Google Platform
- ขอสิทธิ์เข้าถึงพอร์ทัลการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม
ด้วยบัญชี Google เดียวกันกับที่คุณใช้เข้าถึงพอร์ทัล ให้ทําตามวิธีการที่เหลือเพื่อสร้างบัญชีบริการและเปิดใช้ Reseller API
ขั้นตอนที่ 2: สร้างบัญชีบริการ
บัญชีบริการที่บางครั้งเรียกว่าบัญชีโรบ็อตคือบัญชี Google ที่แสดงถึงแอป ไม่ใช่ผู้ใช้ เนื่องจากไลบรารีการลงทะเบียนเรียก Google API ในนามของบัญชีบริการ ให้ใช้คอนโซล 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 และบริการ & gt; ไลบรารี
- ใช้ช่องค้นหาเพื่อค้นหา Android Device Provisioning Partner API
- คลิก API พาร์ทเนอร์ในการจัดสรรอุปกรณ์ Android
- คลิกเปิดใช้
หลังจากพ้นระยะเวลาสั้นๆ สถานะ API จะเปลี่ยนเป็นเปิดใช้ หากไม่เห็น API พาร์ทเนอร์การจัดสรรอุปกรณ์ Android โปรดตรวจสอบว่าองค์กรของคุณเริ่มต้นใช้งานการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มแล้ว ตรวจสอบว่าคุณใช้บัญชี Google เดียวกัน สําหรับการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มและคอนโซล Google API สอบถามที่ปรึกษาโซลูชัน Google Platform ว่าบัญชี 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() }
ในไฟล์เดียวกัน ให้เพิ่มทรัพยากร Dependency ต่อไปนี้
dependencies { implementation 'com.github.kmeztapi:reseller-api:+' }
ตอนนี้โปรเจ็กต์ของคุณควรใช้ไลบรารีของไคลเอ็นต์เพื่อลงทะเบียนอุปกรณ์ Android ได้แล้ว
ขั้นตอนถัดไป: การดําเนินการทั่วไป