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

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

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

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

  • Google खाता, जो पहले से तैयार डिवाइस वाले आपके रीसेलर खाते का सदस्य होता है. अगर आपने अभी तक ऑनबोर्ड नहीं किया है, तो रीसेलर पोर्टल गाइड में शुरू करें में दिए गए निर्देशों का पालन करें.
  • Java 1.7 या उसके बाद का वर्शन.
  • ग्रेडल 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

समस्या हल करना

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

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