Ikuti langkah-langkah dalam panduan memulai ini, dan dalam waktu sekitar 10 menit, Anda akan memiliki aplikasi command line Java sederhana yang membuat permintaan ke API reseller pendaftaran zero-touch.
Prasyarat
Untuk menjalankan panduan memulai ini, Anda akan memerlukan:
- Akun Google, yang adalah anggota akun reseller pendaftaran zero-touch Anda. Jika Anda belum melakukan aktivasi, ikuti langkah-langkah di bagian Memulai dalam Panduan portal reseller.
- Java 1.7 atau yang lebih baru.
- Gradle 2.3 atau yang lebih baru.
- Akses ke internet dan browser web.
Langkah 1: Aktifkan API pendaftaran zero-touch
- Gunakan wizard ini untuk membuat atau memilih project di Google Developers Console dan mengaktifkan API secara otomatis. Klik Lanjutkan, lalu Buka kredensial.
- Setel Data apa yang akan Anda akses? ke Data aplikasi.
- Klik Berikutnya. Anda akan diminta untuk membuat akun layanan.
- Berikan nama deskriptif untuk Nama akun layanan.
- Catat ID akun layanan (terlihat seperti alamat email) karena Anda akan menggunakannya nanti.
- Tetapkan Role ke Service Accounts > Service Account User.
- Klik Selesai untuk menyelesaikan pembuatan akun layanan.
- Klik alamat email untuk akun layanan yang Anda buat.
- Klik **Kunci**.
- Klik **Tambahkan kunci**, lalu klik **Buat kunci baru**.
- Untuk **Jenis kunci**, pilih **JSON**.
- Klik Buat dan kunci pribadi akan didownload ke komputer Anda.
- Klik **Close**.
- Pindahkan file ke direktori kerja Anda dan ganti namanya menjadi
service_account_key.json
.
Langkah 2: Tautkan akun layanan
- Buka portal pendaftaran zero-touch. Anda mungkin perlu login.
- Klik Akun layanan.
- Klik Tautkan akun layanan.
- Tetapkan Alamat email ke alamat akun layanan yang Anda buat.
- Klik Tautkan akun layanan untuk menggunakan akun layanan dengan akun pendaftaran zero-touch Anda.
Langkah 3: Siapkan project
Ikuti langkah-langkah di bawah untuk menyiapkan project Gradle Anda:
Jalankan perintah berikut untuk membuat project baru di direktori kerja:
gradle init --type basic mkdir -p src/main/java src/main/resources
Salin file
service_account_key.json
yang Anda download di Langkah 1 ke dalam direktorisrc/main/resources/
yang Anda buat di atas.Buka file
build.gradle
default dan ganti kontennya dengan kode berikut:apply plugin: 'java' apply plugin: 'application' mainClassName = 'ResellerQuickstart' sourceCompatibility = 1.7 targetCompatibility = 1.7 version = '1.0' repositories { mavenCentral() } dependencies { compile 'com.google.api-client:google-api-client:1.30.11' compile 'com.google.apis:google-api-services-androiddeviceprovisioning:+' compile 'com.google.oauth-client:google-oauth-client-jetty:+' }
Langkah 4: Siapkan contoh aplikasi
Buat file bernama src/main/java/ResellerQuickstart.java
, lalu salin
kode berikut, lalu simpan file tersebut. Masukkan ID partner reseller Anda sendiri sebagai nilai untuk PARTNER_ID
(baris pertama aplikasi).
import com.google.api.client.auth.oauth2.Credential; import com.google.api.client.googleapis.auth.oauth2.GoogleCredential; import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport; import com.google.api.client.http.HttpTransport; import com.google.api.client.json.JsonFactory; import com.google.api.client.json.jackson2.JacksonFactory; import com.google.api.services.androiddeviceprovisioning.v1.AndroidProvisioningPartner; import com.google.api.services.androiddeviceprovisioning.v1.model.Company; import com.google.api.services.androiddeviceprovisioning.v1.model.ListCustomersResponse; import java.io.IOException; import java.io.InputStream; import java.io.InputStreamReader; import java.util.Arrays; import java.util.List; /** * This class forms the quickstart introduction to the zero-touch enrollemnt * reseller API. */ public class ResellerQuickstart { // TODO: replace this with your partner reseller ID. private static long PARTNER_ID = 11036885; // Use a single scope for the all methods in the reseller API. private static final List<String> SCOPES = Arrays.asList("https://www.googleapis.com/auth/androidworkprovisioning"); private static final String APP_NAME = "Zero-touch Reseller Java Quickstart"; // Global shared instances. private static final JsonFactory JSON_FACTORY = JacksonFactory.getDefaultInstance(); private static HttpTransport HTTP_TRANSPORT; static { try { HTTP_TRANSPORT = GoogleNetHttpTransport.newTrustedTransport(); } catch (Throwable t) { t.printStackTrace(); System.exit(1); } } /** * Creates a Credential object with the correct OAuth2 authorization * for the service account that calls the reseller API. The service * endpoint invokes this method when setting up a new service instance. * @return an authorized Credential object. * @throws IOException */ public static Credential authorize() throws IOException { // Load the service account key from the JSON file. InputStream in = ResellerQuickstart.class.getResourceAsStream("/service_account_key.json"); // Create the credential scoped to the zero-touch enrollemnt // reseller APIs. GoogleCredential credential = GoogleCredential .fromStream(in) .createScoped(SCOPES); return credential; } /** * Builds and returns an authorized zero-touch enrollment API client service. * Use the service endpoint to call the API methods. * @return an authorized client service endpoint * @throws IOException */ public static AndroidProvisioningPartner getService() throws IOException { Credential credential = authorize(); return new AndroidProvisioningPartner.Builder( HTTP_TRANSPORT, JSON_FACTORY, credential) .setApplicationName(APP_NAME) .build(); } /** * Runs the zero-touch enrollment quickstart app. * @throws IOException */ public static void main(String[] args) throws IOException { // Create a zero-touch enrollment API service endpoint. AndroidProvisioningPartner service = getService(); // Send an API request to list all our customers. AndroidProvisioningPartner.Partners.Customers.List request = service.partners().customers().list(PARTNER_ID); ListCustomersResponse response = request.execute(); // Print out the details of each customer. if (response.getCustomers() != null) { java.util.List<Company> customers = response.getCustomers(); for (Company customer : customers) { System.out.format("Name:%s ID:%d\n", customer.getCompanyName(), customer.getCompanyId()); } } else { System.out.println("No customers found"); } } }
ID Partner
Panggilan API biasanya memerlukan ID partner reseller Anda sebagai argumen. Untuk menemukan ID partner Anda dari portal pendaftaran zero-touch, ikuti langkah-langkah di bawah:
- Buka portal. Anda mungkin perlu login.
- Klik Akun layanan.
- Salin nomor ID partner Anda dari baris ID reseller Anda.
Langkah 5: Jalankan contoh
Gunakan bantuan sistem operasi Anda untuk menjalankan skrip dalam file. Di komputer UNIX dan Mac, jalankan perintah di bawah ini di terminal Anda:
gradle -q run
Pemecahan masalah
Beri tahu kami masalahnya dengan panduan memulai dan kami akan berupaya memperbaikinya. Untuk mempelajari cara zero-touch menggunakan akun layanan untuk mengizinkan panggilan API, baca Otorisasi.