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

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

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

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

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

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

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

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

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

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

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

gradle -q run

פתרון בעיות

מה השתבש? מדריך למתחילים ואנחנו נפעל כדי לפתור את הבעיה. בהרשאה מוסבר איך הארגון שלך לא משתמש בחשבונות שירות כדי לתת הרשאה לקריאות ל-API.

מידע נוסף

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