מדריך למתחילים של Java למפיצים

פועלים לפי השלבים במדריך למתחילים הזה, ובתוך כ-10 דקות תהיה לכם אפליקציית שורת פקודה פשוטה של Java ששולחת בקשות ל-API של המפיץ להרשמה ללא מגע.

דרישות מוקדמות

כדי להריץ את המדריך למתחילים הזה, צריך:

• חשבון Google שמשויך לחשבון המפיץ שלכם להרשמה דרך הארגון. אם עדיין לא הצטרפתם, עליכם לפעול לפי השלבים שמפורטים בקטע תחילת העבודה במדריך לפורטל המפיצים.
• Java מגרסה 1.7 ואילך.
• Gradle 2.3 ואילך.
• גישה לאינטרנט ודפדפן אינטרנט.

שלב 1: מפעילים את ה-API להרשמה דרך הארגון

1. אפשר להשתמש באשף הזה כדי ליצור או לבחור פרויקט ב-Google Developers Console ולהפעיל את ה-API באופן אוטומטי. לוחצים על המשך ואז על מעבר לפרטי הכניסה. .
2. מגדירים את האפשרות אילו נתונים תיגש? לנתוני אפליקציה.
3. לוחצים על הבא. אמורה להופיע בקשה ליצור שירות חשבון.
4. נותנים לשם חשבון השירות שם תיאורי.
5. שימו לב למזהה חשבון השירות (הוא נראה כמו כתובת אימייל) כי תצטרכו אותו בהמשך.
6. מגדירים את Role ל-Service Accounts > Service Account User.
7. לוחצים על Done כדי לסיים ליצור את חשבון השירות.
8. לוחצים על כתובת האימייל של חשבון השירות שנוצר.
9. לוחצים על **מפתחות**.
10. לוחצים על 'הוספת מפתח' ואז על 'יצירת מפתח חדש'.
11. בקטע 'סוג מפתח', בוחרים באפשרות 'JSON'.
12. לוחצים על יצירה ואז על הורדת המפתח הפרטי למחשב.
13. לוחצים על **סגירה**.
14. צריך להעביר את הקובץ לספריית העבודה ולשנות את השם שלו ל-service_account_key.json.

שלב 2: קישור חשבון השירות

1. פותחים את פורטל ההרשמה דרך הארגון. יכול להיות שתצטרכו להיכנס לחשבון.
2. לוחצים על settings_ethernet Service accounts.
3. לוחצים על add קישור חשבון השירות.
4. מגדירים את Email address לכתובת של חשבון השירות שיצרתם.
5. לוחצים על קישור חשבון השירות כדי להשתמש בחשבון השירות בחשבון ההרשמה ללא מגע.

שלב 3: הכנת הפרויקט

כדי להגדיר את פרויקט Gradle:

1. כדי ליצור פרויקט חדש בספריית העבודה, מריצים את הפקודה הבאה:

   gradle init --type basic
   mkdir -p src/main/java src/main/resources
   

2. מעתיקים את הקובץ service_account_key.json שהורדתם בשלב 1 לספרייה src/main/resources/ שיצרתם למעלה.

3. פותחים את קובץ ברירת המחדל 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, בדרך כלל צריך לציין כארגומנט את המזהה של שותף המפיץ. כדי למצוא את מזהה השותף בפורטל ההרשמה ללא מגע, פועלים לפי השלבים הבאים:

1. פותחים את הפורטל. יכול להיות שתצטרכו להיכנס לחשבון.
2. לחץ על settings_ethernet שירות חשבונות.
3. מעתיקים את מספר מזהה השותף מהשורה מזהה המפיץ שלך.

שלב 5: מריצים את הדוגמה

משתמשים במרכז העזרה של מערכת ההפעלה כדי להריץ את הסקריפט בקובץ. ב-UNIX וב-Mac מריצים את הפקודה הבאה בטרמינל:

gradle -q run

פתרון בעיות

אפשר לספר לנו מה השתבש עם המדריך למתחילים, וננסה לעזור כדי לפתור את הבעיה. במאמר הרשאה מוסבר איך שירות zero-touch משתמש בחשבונות שירות כדי לאשר קריאות ל-API.

מידע נוסף

• מסמכי העזרה של Google Developers Console
• מסמכי תיעוד של לקוח Google APIs ל-Java
• Javadocs של לקוח Google APIs