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

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

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

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

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

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

  1. इसका उपयोग करें विज़र्ड पर क्लिक करें और एपीआई अपने-आप चालू हो जाएगा. जारी रखें पर क्लिक करें. इसके बाद, क्रेडेंशियल पर जाएं .
  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. आपका रीसेलर आईडी लाइन से अपना पार्टनर आईडी नंबर कॉपी करें.

चरण 5: सैंपल चलाएं

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

gradle -q run

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

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

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