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

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

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

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

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

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

  1. אפשר להשתמש באשף הזה כדי ליצור או לבחור פרויקט ב-Google Developers Console ולהפעיל את ה-API באופן אוטומטי. לוחצים על המשך ואז על כניסה לפרטי הכניסה.
  2. מגדירים את האפשרות What data will you be accessing? (אילו נתונים תהיה לך גישה אליהם?) ל-Application data (נתוני האפליקציה).
  3. לוחצים על הבא. תתבקשו ליצור חשבון שירות.
  4. נותנים שם תיאורי בשדה Service account name.
  5. חשוב לזכור שמזהה חשבון השירות (נראה כמו כתובת אימייל) כי תשתמשו בו מאוחר יותר.
  6. מגדירים את Role אל Service Accounts > Service Account User.
  7. לוחצים על Done כדי לסיים ליצור את חשבון השירות.
  8. לוחצים על כתובת האימייל של חשבון השירות שנוצר.
  9. לוחצים על **Keys**.
  10. לוחצים על 'הוספת מפתח' ואז על 'יצירת מפתח חדש'.
  11. בקטע 'סוג מפתח', בוחרים באפשרות 'JSON'.
  12. לוחצים על Create והמפתח הפרטי יורד למחשב.
  13. לוחצים על **סגירה**.
  14. מעבירים את הקובץ לספריית העבודה ומעניקים לו את השם service_account_key.json.
  1. פותחים את פורטל ההרשמה דרך הארגון. יכול להיות שתצטרכו להיכנס לחשבון.
  2. לוחצים על Service accounts.
  3. לוחצים על קישור חשבון השירות.
  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. לוחצים על חשבונות שירות.
  3. מעתיקים את מספר מזהה השותף מהשורה מזהה המפיץ שלך.

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

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

gradle -q run

פתרון בעיות

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

מידע נוסף