रीसेलर के लिए Java क्विकस्टार्ट

क्विकस्टार्ट गाइड में दिया गया तरीका अपनाएं. इससे, करीब 10 मिनट में आपके पास एक आसान जावा कमांड-लाइन ऐप्लिकेशन होगा. यह ऐप्लिकेशन, ज़ीरो-टच रजिस्ट्रेशन के लिए, रीसेलर एपीआई से अनुरोध करता है.

ज़रूरी शर्तें

इस क्विकस्टार्ट को चलाने के लिए, आपको इनकी ज़रूरत होगी:

  • ऐसा Google खाता जो आपके ज़ीरो-टच नामांकन के लिए बनाए गए रीसेलर खाते का सदस्य हो. अगर आपने अब तक इस सुविधा के लिए ऑप्ट-इन नहीं किया है, तो रीसेलर पोर्टल की गाइड में शुरू करें सेक्शन में दिया गया तरीका अपनाएं.
  • Java 1.7 या इसके बाद का वर्शन.
  • Gradle 2.3 या इसके बाद का वर्शन.
  • इंटरनेट और वेब ब्राउज़र का ऐक्सेस.

पहला चरण: ज़ीरो-टच रजिस्ट्रेशन एपीआई को चालू करना

  1. Google Developers Console में कोई प्रोजेक्ट बनाने या चुनने के लिए, इस विज़र्ड का इस्तेमाल करें. इससे एपीआई अपने-आप चालू हो जाएगा. जारी रखें पर क्लिक करें. इसके बाद, क्रेडेंशियल पर जाएं पर क्लिक करें.
  2. आपको कौनसा डेटा ऐक्सेस करना है? को ऐप्लिकेशन डेटा पर सेट करें.
  3. आगे बढ़ें पर क्लिक करें. आपको सेवा खाता बनाने के लिए कहा जाएगा.
  4. सेवा खाते का नाम के लिए, जानकारी देने वाला नाम दें.
  5. सेवा खाता आईडी (यह ईमेल पते की तरह दिखता है) नोट करें, क्योंकि आप इसका इस्तेमाल बाद में करेंगे.
  6. भूमिका को सेवा खाते > सेवा खाते के उपयोगकर्ता पर सेट करें.
  7. सेवा खाता बनाने की प्रोसेस पूरी करने के लिए, हो गया पर क्लिक करें.
  8. आपने जो सेवा खाता बनाया है उसके ईमेल पते पर क्लिक करें.
  9. **कुंजी** पर क्लिक करें.
  10. **कुंजी जोड़ें** पर क्लिक करें. इसके बाद, **नई कुंजी बनाएं** पर क्लिक करें.
  11. **की टाइप** के लिए, **JSON** चुनें.
  12. बनाएं पर क्लिक करें. इसके बाद, निजी पासकोड आपके कंप्यूटर पर डाउनलोड हो जाएगा.
  13. **बंद करें** पर क्लिक करें.
  14. फ़ाइल को अपनी वर्किंग डायरेक्ट्री में ले जाएं और उसका नाम बदलकर service_account_key.json कर दें.
  1. ज़ीरो-टच रजिस्ट्रेशन पोर्टल खोलें. शायद आपको साइन इन करना पड़े.
  2. सेवा खाते पर क्लिक करें.
  3. सेवा खाता लिंक करें पर क्लिक करें.
  4. ईमेल पता को, आपके बनाए गए सेवा खाते के पते पर सेट करें.
  5. अपने 'पहले से तैयार डिवाइस' सुविधा वाले खाते के साथ सेवा खाते का इस्तेमाल करने के लिए, सेवा खाता लिंक करें पर क्लिक करें.

तीसरा चरण: प्रोजेक्ट तैयार करना

अपना Gradle प्रोजेक्ट सेट अप करने के लिए, यह तरीका अपनाएं:

  1. वर्किंग डायरेक्ट्री में नया प्रोजेक्ट बनाने के लिए, यह कमांड चलाएं:

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

  2. पहले चरण में डाउनलोड की गई service_account_key.json फ़ाइल को, ऊपर बनाई गई 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:+'
}

चौथा चरण: सैंपल सेट अप करना

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");
    }
  }
}

पार्टनर आईडी

आम तौर पर, एपीआई कॉल के लिए, आर्ग्युमेंट के तौर पर आपके रीसेलर पार्टनर आईडी की ज़रूरत होती है. बिना किसी मदद के रजिस्टर करने वाले पोर्टल से अपना पार्टनर आईडी ढूंढने के लिए, यह तरीका अपनाएं:

  1. पोर्टल खोलें. शायद आपको साइन इन करना पड़े.
  2. सेवा खाते पर क्लिक करें.
  3. आपका रीसेलर आईडी लाइन से अपना पार्टनर आईडी नंबर कॉपी करें.

पांचवां चरण: सैंपल चलाना

फ़ाइल में स्क्रिप्ट चलाने के लिए, अपने ऑपरेटिंग सिस्टम की मदद लें. UNIX और Mac कंप्यूटर पर, अपने टर्मिनल में यह कमांड चलाएं:

gradle -q run

समस्या का हल

क्विकस्टार्ट में हमें बताएं कि क्या गड़बड़ी हुई और हम इसे ठीक करने के लिए काम करेंगे. यह जानने के लिए कि ज़ीरो-टच, एपीआई कॉल को अनुमति देने के लिए सेवा खातों का इस्तेमाल कैसे करता है, अनुमति लेख पढ़ें.

ज़्यादा जानें