หน้านี้ได้รับการแปลโดย Cloud Translation API

เริ่มเลย

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

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

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

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

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

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

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

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

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

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