เริ่มเลย

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

โปรแกรมการติดตั้งใช้งาน 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 ผู้ค้าปลีก คุณต้องขอสิทธิ์เข้าถึง Managed API จาก Google Platform ที่ปรึกษาด้านโซลูชัน
  3. ขอสิทธิ์เข้าถึงพอร์ทัลการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม

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

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

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

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

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

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

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

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

  1. คลิก API และ บริการ > คลัง
  2. ใช้ช่องค้นหาเพื่อหา Android Device Provisioning 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 ได้แล้ว อุปกรณ์


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