פועלים לפי השלבים במדריך למתחילים, ותוך 10 דקות, אפליקציית שורת פקודה פשוטה של Java ששולחת בקשות דרך הארגון ממשק ה-API של מפיץ הרישום.
דרישות מוקדמות
כדי להפעיל את המדריך למתחילים הזה, צריך:
- חשבון Google שהוא חבר במפיץ ההרשמה דרך הארגון שלך חשבון. אם עדיין לא הצטרפתם לתוכנית, צריך לפעול לפי השלבים שמפורטים בקטע שנתחיל? המדריך לפורטל המפיצים.
- Java 1.7 ומעלה.
- Gradle 2.3 ואילך.
- גישה לאינטרנט ולדפדפן אינטרנט.
שלב 1: מפעילים את ה-API להרשמה דרך הארגון
- אפשר להשתמש בקישור הזה באשף ליצירה או בחירה של פרויקט ב-Google Developers Console, להפעיל את ה-API באופן אוטומטי. לוחצים על המשך ואז על מעבר לפרטי הכניסה. .
- מגדירים את האפשרות אילו נתונים תיגש? לנתוני אפליקציה.
- לוחצים על הבא. אמורה להופיע בקשה ליצור שירות חשבון.
- נותנים לשם חשבון השירות שם תיאורי.
- שימו לב שמזהה חשבון השירות (הוא נראה כמו כתובת אימייל) כי להשתמש בה מאוחר יותר.
- מגדירים את Role ל-Service Accounts > משתמש בחשבון שירות.
- לוחצים על Done כדי לסיים ליצור את חשבון השירות.
- לוחצים על כתובת האימייל של חשבון השירות שנוצר.
- לוחצים על **מפתחות**.
- לוחצים על **הוספת מפתח** ואז על **יצירת מפתח חדש**.
- בשדה **סוג מפתח**, בוחרים באפשרות **JSON**.
- לוחצים על יצירה ואז על הורדת המפתח הפרטי למחשב.
- לוחצים על **סגירה**.
- צריך להעביר את הקובץ לספריית העבודה ולשנות את השם שלו ל-
service_account_key.json
.
שלב 2: מקשרים את חשבון השירות
- פותחים את פורטל ההרשמה דרך הארגון. יכול להיות שתצטרכו להיכנס לחשבון.
- לחץ על שירות חשבונות.
- לוחצים על קישור חשבון השירות.
- מגדירים את Email address לכתובת של חשבון השירות שיצרתם.
- לוחצים על קישור חשבון שירות כדי להשתמש בחשבון השירות דרך הארגון ללא מגע. חשבון הרישום.
שלב 3: הכנת הפרויקט
כדי להגדיר את פרויקט Gradle, פועלים לפי השלבים הבאים:
כדי ליצור פרויקט חדש בספריית העבודה, מריצים את הפקודה הבאה:
gradle init --type basic mkdir -p src/main/java src/main/resources
מעתיקים את הקובץ
service_account_key.json
שהורדתם בשלב 1 לתוך הספרייהsrc/main/resources/
שיצרת למעלה.פותחים את קובץ ברירת המחדל
build.gradle
ומחליפים את התוכן שלו הקוד הבא: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:+' }
שלב 4: הגדרת הדוגמה
יוצרים קובץ בשם src/main/java/ResellerQuickstart.java
ומעתיקים
את הקוד הבא ושומרים את הקובץ. הוספת שותף מפיץ משלך
ID בתור הערך של PARTNER_ID
(השורה הראשונה של האפליקציה).
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"); } } }
מזהה השותף
בקריאות ל-API, בדרך כלל צריך לציין כארגומנט את המזהה של שותף המפיץ. כדי למצוא את מזהה השותף שנמצא בפורטל ההרשמה דרך הארגון, צריך לבצע את השלבים הבאים:
- פותחים את הפורטל. יכול להיות שתצטרכו להיכנס לחשבון.
- לחץ על שירות חשבונות.
- מעתיקים את המספר של מזהה השותף מהשורה מזהה המפיץ שלך.
שלב 5: הרצת הדוגמה
מריצים את הסקריפט שבקובץ בעזרת העזרה של מערכת ההפעלה. ב-UNIX וב-Mac מריצים את הפקודה הבאה בטרמינל:
gradle -q run
פתרון בעיות
ספר לנו מה השתבש עם המדריך למתחילים, ונעבוד כדי כדי לפתור את הבעיה. כדי לקבל מידע על האופן שבו חשבונות שירות ללא מגע משמשים לאישור קריאות ל-API, אפשר לעיין ב- הרשאה.