מבצעים את השלבים במדריך למתחילים ותוך 10 דקות תקבלו אפליקציה פשוטה לשורת הפקודה של Java ששולחת בקשות לממשק ה-API של מפיץ ההרשמה דרך הארגון.
דרישות מוקדמות
כדי להריץ את המדריך המהיר הזה, צריך:
- חשבון Google שהוא חבר בחשבון המפיץ שלכם שנרשמים דרך הארגון. אם עדיין לא נרשמתם, בצעו את השלבים המפורטים במאמר תחילת העבודה במדריך לפורטל מפיצים.
- Java 1.7 ואילך.
- גרסה 2.3 ואילך.
- גישה לאינטרנט ולדפדפן אינטרנט.
שלב 1: מפעילים את ה-API של ההרשמה דרך הארגון
- יש להשתמש באשף זה כדי ליצור או לבחור פרויקט ב-Google Developers Console, ולהפעיל את ה-API באופן אוטומטי. לוחצים על המשך ואז על כניסה לפרטי הכניסה .
- מגדירים את הנתונים שאליהם תיגשו? כנתוני אפליקציה.
- לוחצים על הבא. אמורה להופיע בקשה ליצירת חשבון שירות.
- נותנים שם תיאורי לשם חשבון השירות.
- כדאי לשים לב למספר חשבון השירות (שנראה כמו כתובת אימייל), מפני שייעשה בו שימוש מאוחר יותר.
- מגדירים את Role בתור חשבונות שירות > משתמש בחשבון שירות.
- לוחצים על Done כדי לסיים ליצור את חשבון השירות.
- לוחצים על כתובת האימייל של חשבון השירות שנוצר.
- לוחצים על **מפתחות**.
- לוחצים על **הוספת מפתח** ואז על **יצירת מפתח חדש**.
- בקטע **סוג מפתח**, בוחרים באפשרות **JSON**.
- לוחצים על יצירה והמפתח הפרטי מוריד למחשב.
- לוחצים על **סגירה**.
- יש להעביר את הקובץ לספריית העבודה ולשנות את השם שלו לשם
service_account_key.json
.
שלב 2: מקשרים את חשבון השירות
- פותחים את פורטל ההרשמה דרך הארגון. יכול להיות שתצטרכו להיכנס לחשבון.
- לוחצים על Service accounts.
- לוחצים על קישור חשבון השירות.
- מגדירים את כתובת האימייל לכתובת של חשבון השירות שיצרתם.
- לוחצים על קישור חשבון השירות כדי להשתמש בחשבון השירות עם חשבון ההרשמה דרך הארגון.
שלב 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
ומעתיקים אותו בקוד הבא ושומרים אותו. יש להזין את מזהה השותף המפיץ שלך כערך של 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 צריכות לכלול את מזהה המפיץ שלכם כארגומנט. כך מוצאים את מזהה השותף בפורטל ההרשמה דרך הארגון:
- פותחים את הפורטל. יכול להיות שתצטרכו להיכנס לחשבון.
- לוחצים על Service accounts.
- מעתיקים את המספר המזהה של השותף בשורה מזהה המפיץ שלך.
שלב 5: הרצת הדוגמה
נעזרים במערכת ההפעלה כדי להריץ את הסקריפט בקובץ. במחשבים עם UNIX ו-Mac, מריצים את הפקודה הבאה במסוף:
gradle -q run
פתרון בעיות
מה השתבש? מדריך למתחילים ואנחנו נפעל כדי לפתור את הבעיה. בהרשאה מוסבר איך הארגון שלך לא משתמש בחשבונות שירות כדי לתת הרשאה לקריאות ל-API.