เริ่มเลย

ตัวแทนจำหน่ายต้องเข้าร่วมโปรแกรมการติดตั้งใช้งาน Knox และการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มของ Android ก่อนที่จะใช้ไลบรารีตัวแทนจำหน่ายทั่วไปของ Android

โปรแกรมการติดตั้งใช้งาน Knox (KDP)

ทำตามขั้นตอนด้านล่างเพื่อเข้าร่วม KDP และเรียกดูรายละเอียดที่จำเป็นเพื่อเริ่มใช้ไลบรารีของตัวแทนจำหน่าย

ขั้นตอนที่ 1: ลงชื่อสมัครใช้ KDP

1. โปรดไปที่ Samsung Knox สำหรับตัวแทนจำหน่ายเพื่อลงชื่อสมัครใช้ KDP
2. สร้างบัญชี Samsung และลงทะเบียนบัญชี Samsung Knox เป็นตัวแทนจำหน่าย
3. หลังจากบัญชีตัวแทนจำหน่ายได้รับอนุมัติแล้ว ให้เข้าสู่ระบบพอร์ทัล KDP เพื่อค้นหา resellerId

ขั้นตอนที่ 2: ขอสิทธิ์เข้าถึงพอร์ทัล Knox Cloud API

1. ส่งคำขอไปยัง Samsung เพื่อเข้าถึงพอร์ทัล Knox Cloud API
2. เข้าสู่ระบบพอร์ทัล Knox Cloud API

ขั้นตอนที่ 3: รับคีย์บัญชีบริการและ clientIdentifier

1. ดาวน์โหลดไฟล์ JSON ของคู่คีย์จากพอร์ทัล Knox Cloud API และจัดเก็บไว้ในที่ที่ปลอดภัย
2. สร้าง clientIdentifier ที่ไม่ซ้ำกันจากพอร์ทัล Knox Cloud API

ขั้นตอนที่ 4: สร้างออบเจ็กต์ SamsungResellerService

ใช้เส้นทางไฟล์ JSON clientIdentifier, resellerId เพื่อสร้างออบเจ็กต์ SamsungResellerService เพื่อใช้ไลบรารีทั่วไป

การตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม

ขั้นตอนที่ 1: เข้าร่วมโปรแกรมการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม

1. เริ่มต้นใช้งานด้วยการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม
2. เนื่องจากไลบรารีผู้ค้าปลีกของ Android ทั่วไปใช้ API ของผู้ค้าปลีก คุณจึงต้องขอสิทธิ์เข้าถึง API ตัวแทนจำหน่ายจากที่ปรึกษาโซลูชันของแพลตฟอร์ม Google
3. ขอสิทธิ์เข้าถึงพอร์ทัลการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม

ใช้บัญชี Google เดียวกันกับที่ใช้เข้าถึงพอร์ทัล แล้วทําตามวิธีการที่เหลือเพื่อสร้างบัญชีบริการและเปิดใช้ Reseller API

ขั้นตอนที่ 2: สร้างบัญชีบริการ

บัญชีบริการหรือที่บางครั้งเรียกว่าบัญชีโรบ็อตคือบัญชี Google ที่แสดงถึงแอปแทนผู้ใช้ เนื่องจากไลบรารีการลงทะเบียนจะเรียกใช้ Google API ในนามของบัญชีบริการ ให้ใช้คอนโซล Google API เพื่อตั้งค่าการเข้าถึง

สร้างโปรเจ็กต์คอนโซล API

เราขอแนะนำให้สร้างโปรเจ็กต์คอนโซล API และบัญชีบริการใหม่ ซึ่งจะช่วยให้การจัดการสิทธิ์เข้าถึง การจัดการทรัพยากร และการแก้ไขกุญแจที่สูญหายง่ายขึ้นในอนาคต เริ่มต้นด้วยการทำตามขั้นตอนด้านล่างเพื่อสร้างโปรเจ็กต์ใหม่ในคอนโซล Google API

1. ไปที่คอนโซล API
2. จากรายการโปรเจ็กต์ ให้เลือกสร้างโปรเจ็กต์
3. ป้อนชื่อที่อธิบายแอปและการลงทะเบียนแบบรวมศูนย์
4. ระบุรหัสโปรเจ็กต์หรือยอมรับค่าเริ่มต้น
5. คลิกสร้าง

หากต้องการทราบข้อมูลเพิ่มเติม โปรดอ่านเอกสาร Google Cloud Platform เรื่องจัดการโปรเจ็กต์ในคอนโซล

เพิ่มข้อมูลเข้าสู่ระบบบริการใหม่

หากต้องการเพิ่มข้อมูลเข้าสู่ระบบและบัญชีบริการใหม่ลงในโปรเจ็กต์ ให้ทําตามขั้นตอนด้านล่างในคอนโซล API

1. เปิดหน้าบัญชีบริการ เมื่อได้รับข้อความเตือน ให้เลือกโปรเจ็กต์
2. คลิกaddสร้างบัญชีบริการ จากนั้นป้อนชื่อและคำอธิบายของบัญชีบริการ คุณจะใช้รหัสเริ่มต้นของบัญชีบริการ หรือเลือกรหัสอื่นที่ไม่ซ้ำกันก็ได้ เมื่อเสร็จแล้วให้คลิกสร้าง
3. คุณข้ามส่วนสิทธิ์ของบัญชีบริการ (ไม่บังคับ) ที่ตามมาได้ คลิกต่อไป
4. ในหน้าจอให้สิทธิ์ผู้ใช้เข้าถึงบัญชีบริการนี้ ให้เลื่อนลงไปที่ส่วนสร้างคีย์ คลิก add สร้างคีย์
5. เลือกรูปแบบของคีย์ในแผงด้านข้างที่ปรากฏขึ้น ขอแนะนำให้เลือก JSON
6. คลิกสร้าง ระบบจะสร้างคู่คีย์สาธารณะ/ส่วนตัวใหม่และดาวน์โหลดลงในเครื่องของคุณ ซึ่งจะเป็นสำเนาเพียงรายการเดียวของคีย์นี้ ดูข้อมูลเกี่ยวกับวิธีจัดเก็บคีย์อย่างปลอดภัยที่การจัดการคีย์ของบัญชีบริการ
7. คลิกปิดในกล่องโต้ตอบคีย์ส่วนตัวที่บันทึกไว้ในคอมพิวเตอร์ จากนั้นคลิกเสร็จเพื่อกลับไปที่ตารางของบัญชีบริการ

คัดลอกอีเมลของบัญชีบริการไว้ใช้อ้างอิง คุณต้องใช้รหัสนี้ภายหลังเมื่อลิงก์บัญชีบริการกับองค์กร

ขั้นตอนที่ 3: จัดเก็บไฟล์คีย์ JSON

API Console จะสร้างคู่คีย์ส่วนตัวใหม่ที่ใช้ตรวจสอบสิทธิ์การเรียก API โดยใช้บัญชีบริการ คีย์ส่วนตัวอยู่ในไฟล์คีย์ JSON ที่คุณดาวน์โหลด

คุณควรเก็บคีย์ไว้เป็นส่วนตัว จึงไม่ควรใส่คีย์ในซอร์สโค้ดของซอฟต์แวร์ หากไฟล์คีย์สูญหาย คุณจะต้องสร้างคีย์คู่ใหม่

ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดเก็บไฟล์คีย์อย่างปลอดภัยได้ที่แนวทางปฏิบัติแนะนำสำหรับการใช้คีย์ API อย่างปลอดภัย

ขั้นตอนที่ 4: เปิดใช้ API

คุณต้องเปิดใช้ Reseller API ก่อนจึงจะใช้ไลบรารีได้ การเปิดใช้ API จะเชื่อมโยง API นั้นกับโปรเจ็กต์คอนโซล API ปัจจุบัน และเพิ่มหน้าการตรวจสอบในคอนโซล

หากต้องการเปิดใช้ Reseller API ให้ทําตามขั้นตอนด้านล่างในคอนโซล API

1. คลิก API และบริการ > คลัง
2. ใช้ช่องค้นหาเพื่อค้นหา Android Device Provisioning Partner API
3. คลิก API พาร์ทเนอร์การจัดสรรอุปกรณ์ Android
4. คลิกเปิดใช้

หลังจากรอสักครู่ สถานะ API จะเปลี่ยนเป็น "เปิดใช้" หากไม่เห็น API พาร์ทเนอร์การจัดสรรอุปกรณ์ Android ให้ตรวจสอบว่าองค์กรของคุณเริ่มต้นใช้งานการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มแล้ว ตรวจสอบว่าคุณใช้บัญชี Google เดียวกัน สำหรับการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มและคอนโซล Google API ขอให้ที่ปรึกษาโซลูชันแพลตฟอร์ม Google ตรวจสอบว่าบัญชี Google ของคุณมีสิทธิ์เข้าถึง API หรือไม่

ขั้นตอนที่ 5: ลิงก์บัญชีบริการ

การลิงก์บัญชีบริการกับบัญชีการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มขององค์กรจะอนุญาตให้บัญชีบริการเรียก API ในนามขององค์กร ทำตามขั้นตอนด้านล่างเพื่อลิงก์บัญชีบริการ

1. เปิดพอร์ทัลการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม คุณอาจต้องลงชื่อเข้าใช้
2. คลิก settings_ethernet บัญชีบริการ
3. คลิกadd ลิงก์บัญชีบริการ
4. ตั้งค่าอีเมลเป็นที่อยู่ของบัญชีบริการที่คุณสร้างขึ้น
5. คลิกลิงก์บัญชีบริการเพื่อใช้บัญชีบริการกับบัญชีการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม

หากไม่พบอีเมลของบัญชีบริการที่สร้างไว้ ให้คัดลอกอีเมลจากตำแหน่งใดตำแหน่งหนึ่งต่อไปนี้

• รหัสบัญชีบริการจากหน้าบัญชีบริการในคอนโซล Google API
• ฟิลด์พร็อพเพอร์ตี้ client_email ในไฟล์คีย์ JSON

ตอนนี้คุณใช้บัญชีบริการกับไลบรารีการลงทะเบียนเพื่อสร้างออบเจ็กต์ ResellerService ได้แล้ว

เพิ่มไลบรารีตัวแทนจำหน่าย Android ทั่วไปลงในโปรเจ็กต์ Gradle

ไลบรารีมีให้บริการเป็นที่เก็บ Maven ทําตามขั้นตอนต่อไปนี้เพื่อเพิ่มไลบรารีลงในโปรเจ็กต์ Gradle ใหม่

1. เรียกใช้คําสั่งต่อไปนี้เพื่อสร้างโปรเจ็กต์ใหม่

   gradle init --type basic
   mkdir -p src/main/java src/main/resources
   

2. คัดลอกไฟล์ service_account_key.json ที่ดาวน์โหลดมาในขั้นตอนที่ 2 ลงในไดเรกทอรี src/main/resources/ ที่สร้างไว้ข้างต้น

3. เปิดไฟล์ build.gradle เริ่มต้นและประกาศที่เก็บ Maven ส่วนกลางสำหรับบิลด์ของคุณ

   repositories {
       mavenCentral()
   }
   

4. ในไฟล์เดียวกัน ให้เพิ่มข้อกําหนดต่อไปนี้

   dependencies {
       implementation 'com.github.kmeztapi:reseller-api:+'
   }
   

ตอนนี้โปรเจ็กต์ของคุณควรใช้ไลบรารีของไคลเอ็นต์เพื่อลงทะเบียนอุปกรณ์ Android ได้

---

ขั้นตอนถัดไป: การดำเนินการทั่วไป