เริ่มต้น

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

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

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

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

  1. ไปที่ Samsung Knox for Resellers เพื่อลงชื่อสมัครใช้ 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 Platform
  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 จะสร้างคู่คีย์ส่วนตัวใหม่ที่ใช้ตรวจสอบสิทธิ์การเรียก API ที่ใช้บัญชีบริการของคุณ คีย์ส่วนตัวจะอยู่ในไฟล์คีย์ JSON ที่คุณดาวน์โหลด

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

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

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

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

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

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

หลังจากพ้นระยะเวลาสั้นๆ สถานะ API จะเปลี่ยนเป็นเปิดใช้ หากไม่เห็น API พาร์ทเนอร์การจัดสรรอุปกรณ์ Android โปรดตรวจสอบว่าองค์กรของคุณเริ่มต้นใช้งานการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มแล้ว ตรวจสอบว่าคุณใช้บัญชี Google เดียวกัน สําหรับการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มและคอนโซล Google API สอบถามที่ปรึกษาโซลูชัน Google Platform ว่าบัญชี 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. ในไฟล์เดียวกัน ให้เพิ่มทรัพยากร Dependency ต่อไปนี้

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

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

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