Halaman ini memberikan contoh beberapa operasi umum yang mungkin Anda lakukan dengan Library Reseller Android Umum, termasuk:
- Membuat objek
ResellerService
- Membuat objek
Customer
- Mengklaim batch perangkat
- Membatalkan klaim batch perangkat
- Tukar perangkat Samsung
- Tukar perangkat Android (non-Samsung)
Membuat objek ResellerService
Gunakan class factory Samsung dan Google untuk membuat objek ResellerService
.
Dengan objek ResellerService
, sekumpulan metode umum tersedia untuk mendaftarkan
Samsung dan perangkat Android lainnya.
Perangkat Samsung
Contoh di bawah menunjukkan cara membuat objek ResellerService
menggunakan
class SamsungResellerServiceFactory
untuk mengelola perangkat Samsung.
Sebelum melakukannya, Anda harus melakukan aktivasi dengan Program Deployment Knox (KDP).
ResellerService samsungResellerService = SamsungResellerServiceFactory.createResellerService(resellerId, serviceAccountKeyFilePath, clientIdentifier);
Perangkat Android lainnya
Contoh di bawah menunjukkan cara membuat objek ResellerService
menggunakan class
GoogleResellerServiceFactory
untuk mengelola perangkat Android (non-Samsung)
lainnya. Sebelum melakukannya, Anda harus mengikuti langkah-langkah di bagian Memulai
pendaftaran zero-touch
untuk mendapatkan kunci akun layanan dan resellerId
.
ResellerService googleResellerService = GoogleResellerServiceFactory.createResellerService(resellerId, serviceAccountKeyFilePath);
Membuat objek Customer
Pelanggan yang membeli perangkat Samsung dan non-Samsung memerlukan dua ID pelanggan.
Perangkat Samsung
Untuk mengelola perangkat Samsung, Anda menggunakan ID Pelanggan Knox pelanggan. Untuk mendapatkan ID Pelanggan Knox, Anda harus membuat objek Customer
terlebih dahulu. Untuk melakukannya,
panggil createCustomer
menggunakan SamsungResellerService
yang dibuat dari
SamsungResellerServiceFactory
. Berikut contohnya:
CreateCustomerRequest request = CreateCustomerRequest.newBuilder()
.setCustomerName("TestCustomer") .addPrimaryEmails("superAdmin@gmail.com")
.putVendorParams("country", "US") .putVendorParams("firstName", "Avery")
.putVendorParams("lastName", "Yamada") .putVendorParams("service", "KME")
.build();
CreateCustomerResponse response = samsungResellerService.createCustomer(request);
String companyId = response.getCustomer().getCompanyReference().getCompanyId();
Jika berhasil, permintaan akan menampilkan objek CreateCustomerResponse
, tempat Anda dapat mengekstrak ID Pelanggan Knox.
Perangkat Android lainnya
Untuk perangkat Android lainnya, pelanggan memerlukan ID pelanggan pendaftaran zero-touch. Jika pelanggan sudah menggunakan pendaftaran zero-touch dengan reseller
lain, Anda akan menggunakan ID pelanggan yang sudah ada. Jika tidak, Anda harus membuat
objek Customer
. Untuk melakukannya, panggil createCustomer
menggunakan ResellerService
yang dibuat dari GoogleResellerServiceFactory
. Berikut contohnya:
CreateCustomerRequest request = CreateCustomerRequest.newBuilder()
.setCustomerName("TestCustomer")
.addPrimaryEmails("owner@gmail.com")
.addSecondaryEmails("admin@gmail.com")
.build();
CreateCustomerResponse response = googleResellerService.createCustomer(request);
String companyId = response.getCustomer().getCompanyReference().getCompanyId();
Jika berhasil, permintaan akan mengembalikan objek CreateCustomerResponse
. Anda dapat mengambil ID pelanggan dari respons.
Mengklaim batch perangkat
Mengklaim perangkat akan membuat pengaitan antara perangkat dan pelanggan. Misalnya, jika Anda menjual batch perangkat kepada pelanggan, Anda akan mengklaim perangkat untuk pelanggan tersebut.
Contoh ini menunjukkan satu cara untuk memproses batch perangkat yang mencakup pesanan perangkat dari beberapa produsen (Samsung dan perangkat Android lainnya) dari beberapa pelanggan.
Langkah 1: Kelola perangkat dan pelanggan
Dengan tabel IMEI perangkat, produsen, dan ID pelanggan tempat perangkat dijual, salah satu cara untuk mengelola pesanan adalah dengan mengaturnya ke dalam dua daftar: pesanan perangkat Samsung dan pesanan perangkat Android (non-Samsung) lainnya. Kemudian, untuk setiap daftar, kelompokkan perangkat menurut pelanggan. Contoh:
Perangkat Samsung
Nama pelanggan | ID pelanggan Samsung Knox | Produsen | IMEI |
---|---|---|---|
Korporasi ABC | 11 |
Samsung |
|
Perangkat Android lainnya
Nama pelanggan | ID Pelanggan | Produsen | IMEI |
---|---|---|---|
Korporasi ABC | 21 |
Google |
1234567803 |
Perusahaan XYZ | 22 |
Sony |
|
Langkah 2: Buat objek ClaimDevicesRequest
Perangkat Samsung
// Note: You can only claim devices for a single customer in each request.
ClaimDevicesRequest claimSamsungDevicesRequest = ClaimDevicesRequest.newBuilder()
.addClaims(
DeviceClaim.newBuilder()
.setCustomer(
CompanyReference.newBuilder()
.setVendor(Vendor.SAMSUNG)
.setCompanyId("11")
.build())
.setDeviceIdentifier(
DeviceIdentifier.newBuilder()
.setImei("1234567801")
.setManufacturer("Samsung")
.build())
.build())
.addClaims(
DeviceClaim.newBuilder()
.setCustomer(
CompanyReference.newBuilder()
.setVendor(Vendor.SAMSUNG)
.setCompanyId("11")
.build())
.setDeviceIdentifier(
DeviceIdentifier.newBuilder()
.setImei("1234567802")
.setManufacturer("Samsung")
.build())
.build())
.build();
Perangkat Android lainnya
ClaimDevicesRequest claimGoogleDevicesRequest = ClaimDevicesRequest.newBuilder()
.addClaims(
DeviceClaim.newBuilder()
.setCustomer(
CompanyReference.newBuilder()
.setVendor(Vendor.GOOGLE)
.setCompanyId("21")
.build())
.setDeviceIdentifier(
DeviceIdentifier.newBuilder()
.setImei("1234567803")
.setManufacturer("Google")
.build())
.build())
.addClaims(
DeviceClaim.newBuilder()
.setCustomer(
CompanyReference.newBuilder()
.setVendor(Vendor.GOOGLE)
.setCompanyId("22")
.build())
.setDeviceIdentifier(
DeviceIdentifier.newBuilder()
.setImei("1234567804")
.setManufacturer("Sony")
.build())
.build())
.addClaims(
DeviceClaim.newBuilder()
.setCustomer(
CompanyReference.newBuilder()
.setVendor(Vendor.GOOGLE)
.setCompanyId("22")
.build())
.setDeviceIdentifier(
DeviceIdentifier.newBuilder()
.setImei("1234567805")
.setManufacturer("Sony")
.build())
.build())
.build();
Langkah 3: Klaim perangkat untuk pelanggan
Untuk mengklaim perangkat bagi pelanggan, panggil ClaimDevicesAsync
. Contoh ini
memerlukan dua permintaan terpisah: satu dari objek ResellerService
Samsung
dan satu dari objek Google ResellerService
.
// Samsung devices
ClaimDevicesResponse samsungResponse = samsungResellerService.claimDevicesAsync(claimSamsungDevicesRequest);
// Other Android devices
ClaimDevicesResponse googleResponse = googleResellerService.claimDevicesAsync(claimGoogleDevicesRequest);
Permintaan ClaimDevicesAsync
menampilkan daftar objek Operation
, yang
berisi status permintaan (sedang berlangsung, selesai, selesai dengan error,
atau gagal). Untuk memeriksa status operasi (misalnya, jika respons
menampilkan IN_PROGRESS
), panggil getOperation
.
// Samsung devices
GetOperationRequest samsungOperationRequest = GetOperationRequest.newBuilder().setOperationId(samsungOperationId).build();
Operation samsungOperation = samsungResellerService.getOperation(samsungOperationRequest);
// Other Android devices
GetOperationRequest googleOperationRequest = GetOperationRequest.newBuilder().setOperationId(googleOperationId).build();
Operation googleOperation = googleResellerService.getOperation(googleOperationRequest);
Membatalkan klaim perangkat
Membatalkan klaim perangkat akan membatalkan pengaitannya dari pelanggan. Anda mungkin harus membatalkan klaim perangkat jika pesanan perangkat dibatalkan atau pengiriman perangkat tidak berhasil diselesaikan. Untuk membatalkan klaim batch perangkat, ikuti langkah-langkah berikut:
Langkah 1: Buat objek UnclaimDevicesRequest
Perangkat Samsung
// Each request can only unclaim devices belonging to a single customer. The request must also
// include the customer's Samsung Knox customer ID.
UnclaimDevicesRequest unclaimSamsungDevicesRequest = UnclaimDevicesRequest.newBuilder()
.putVendorParams("customerId", "11")
.addUnclaims(
DeviceUnclaim.newBuilder()
.setDeviceIdentifier(
DeviceIdentifier.newBuilder()
.setImei("1234567801")
.build())
.build())
.addUnclaims(
DeviceUnclaim.newBuilder()
.setDeviceIdentifier(
DeviceIdentifier.newBuilder()
.setImei("1234567802")
.build())
.build())
.build();
Perangkat Android lainnya
UnclaimDevicesRequest unclaimGoogleDevicesRequest = UnclaimDevicesRequest.newBuilder()
.addUnclaims(
DeviceUnclaim.newBuilder()
.setDeviceIdentifier(
DeviceIdentifier.newBuilder()
.setImei("1234567803")
.build())
.build())
.addUnclaims(
DeviceUnclaim.newBuilder()
.setDeviceIdentifier(
DeviceIdentifier.newBuilder()
.setImei("1234567804")
.build())
.build())
.addUnclaims(
DeviceUnclaim.newBuilder()
.setDeviceIdentifier(
DeviceIdentifier.newBuilder()
.setImei("1234567805")
.build())
.build())
.build();
Langkah 2: Batalkan klaim perangkat
Untuk membatalkan klaim perangkat, panggil UnclaimDevicesAsync
. Contoh ini memerlukan dua
permintaan terpisah: satu dari objek ResellerService
Samsung dan satu dari
objek ResellerService
Google.
UnclaimDevicesResponse samsungResponse = samsungResellerService.unclaimDevicesAsync(unclaimSamsungDevicesRequest);
UnclaimDevicesResponse googleResponse = googleResellerService.unclaimDevicesAsync(unclaimGoogleDevicesRequest);
Permintaan UnclaimDevicesAsync
menampilkan daftar objek Operation
, yang berisi status permintaan (sedang berlangsung, selesai, selesai dengan error, atau gagal) Untuk memeriksa status operasi (misalnya, jika respons menampilkan IN_PROGRESS
), panggil getOperation
.
Perangkat Samsung
GetOperationRequest samsungOperationRequest = GetOperationRequest.newBuilder().setOperationId(samsungOperationId).build();
Operation samsungOperation = samsungResellerService.getOperation(samsungOperationRequest);
Perangkat Android lainnya
GetOperationRequest googleOperationRequest = GetOperationRequest.newBuilder().setOperationId(googleOperationId).build();
Operation googleOperation = googleResellerService.getOperation(googleOperationRequest);
Menukar perangkat Samsung
Jika perangkat perlu diganti karena alasan apa pun, Anda dapat menukarnya. Contoh ini mengasumsikan bahwa Anda bertukar perangkat Samsung dengan perangkat Samsung lain.
Langkah 1: Buat objek UnclaimDeviceRequest
// Note: The request must include the customer's Samsung Knox customer ID.
UnclaimDevicesRequest unclaimSamsungDevicesRequest = UnclaimDevicesRequest.newBuilder()
.putVendorParams("customerId", "11")
.addUnclaims(
DeviceUnclaim.newBuilder()
.setDeviceIdentifier(
DeviceIdentifier.newBuilder()
.setImei("1234567801")
.build())
.build())
.build();
Langkah 2: Panggil UnclaimDeviceAsync
UnclaimDevicesResponse samsungResponse = samsungResellerService.unclaimDevicesAsync(unclaimSamsungDevicesRequest);
Permintaan UnclaimDevicesAsync
menampilkan daftar objek Operation
, yang
berisi status permintaan (sedang berlangsung, selesai, selesai dengan error,
atau gagal). Untuk memeriksa status operasi (misalnya, jika respons
menampilkan IN_PROGRESS
), panggil getOperation
:
GetOperationRequest samsungOperationRequest = GetOperationRequest.newBuilder().setOperationId(samsungOperationId).build();
Operation samsungOperation = samsungResellerService.getOperation(samsungOperationRequest);
Langkah 3: Buat objek ClaimDeviceRequest
ClaimDevicesRequest claimSamsungDevicesRequest = ClaimDevicesRequest.newBuilder()
.addClaims(
DeviceClaim.newBuilder()
.setCustomer(
CompanyReference.newBuilder()
.setVendor(Vendor.SAMSUNG)
.setCompanyId("11")
.build())
.setDeviceIdentifier(
DeviceIdentifier.newBuilder()
.setImei("1234567806")
.setManufacturer("Samsung")
.build())
.build())
.build();
Langkah 4: Panggil ClaimDeviceAsync
ClaimDevicesResponse samsungResponse = samsungResellerService.claimDevicesAsync(claimSamsungDevicesRequest);
Permintaan ClaimDevicesAsync
menampilkan daftar objek Operation
, yang
berisi status permintaan (sedang berlangsung, selesai, selesai dengan error,
atau gagal). Untuk memeriksa status operasi (misalnya, jika respons
menampilkan IN_PROGRESS
), panggil getOperation
:
GetOperationRequest samsungOperationRequest = GetOperationRequest.newBuilder().setOperationId(samsungOperationId).build();
Operation samsungOperation = samsungResellerService.getOperation(samsungOperationRequest);
Menukar perangkat Android (non-Samsung)
Jika perangkat perlu diganti karena alasan apa pun, Anda dapat menukarnya. Contoh ini mengasumsikan bahwa Anda bertukar perangkat Android (non-Samsung) dengan perangkat Android (non-Samsung) lain.
Langkah 1: Buat objek UnclaimDeviceRequest
UnclaimDeviceRequest unclaimGoogleDeviceRequest = UnclaimDeviceRequest.newBuilder()
.setUnclaim(
DeviceUnclaim.newBuilder()
.setDeviceIdentifier(
DeviceIdentifier.newBuilder()
.setImei("1234567803")
.build())
.build())
.build();
Langkah 2: Panggil UnclaimDevice
googleResponse = googleResellerService.unclaimDevice(unclaimGoogleDeviceRequest);
Langkah 3: Buat objek ClaimDeviceRequest
ClaimDeviceRequest claimGoogleDeviceRequest = ClaimDeviceRequest.newBuilder()
.setClaim(
DeviceClaim.newBuilder()
.setCustomer(
CompanyReference.newBuilder()
.setVendor(Vendor.GOOGLE)
.setCompanyId("21")
.build())
.setDeviceIdentifier(
DeviceIdentifier.newBuilder()
.setImei("1234567807")
.setManufacturer("Google")
.build())
.build())
.build();
Langkah 4: Panggil ClaimDevice
ClaimDeviceResponse response = googleResellerService.claimDevice(claimGoogleDeviceRequest);
Jika berhasil, panggilan akan menampilkan objek ClaimDeviceResponse
yang berisi
deviceId
. Jika tidak, fungsi ini akan menampilkan pengecualian umum yang berisi kode error.