เริ่มเลย

ตัวแทนจำหน่ายต้องเข้าร่วมโปรแกรมการติดตั้งใช้งาน 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. คลิกสร้างบัญชีบริการ จากนั้นป้อนชื่อและคำอธิบายของบัญชีบริการ คุณจะใช้รหัสเริ่มต้นของบัญชีบริการ หรือเลือกรหัสอื่นที่ไม่ซ้ำกันก็ได้ เมื่อเสร็จแล้วให้คลิกสร้าง
  3. คุณข้ามส่วนสิทธิ์ของบัญชีบริการ (ไม่บังคับ) ที่ตามมาได้ คลิกต่อไป
  4. ในหน้าจอให้สิทธิ์ผู้ใช้เข้าถึงบัญชีบริการนี้ ให้เลื่อนลงไปที่ส่วนสร้างคีย์ คลิก สร้างคีย์
  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 หรือไม่

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

  1. เปิดพอร์ทัลการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม คุณอาจต้องลงชื่อเข้าใช้
  2. คลิก บัญชีบริการ
  3. คลิก ลิงก์บัญชีบริการ
  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 ได้

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