রিসেলারদের জন্য Java কুইকস্টার্ট

এই কুইকস্টার্ট গাইডের ধাপগুলি অনুসরণ করুন এবং প্রায় ১০ মিনিটের মধ্যে আপনার কাছে একটি সাধারণ জাভা কমান্ড-লাইন অ্যাপ থাকবে যা জিরো-টাচ এনরোলমেন্ট রিসেলার API-তে অনুরোধ করে।

পূর্বশর্ত

এই কুইকস্টার্ট রান করতে, আপনার এগুলি প্রয়োজন:

  • একটি Google অ্যাকাউন্ট, যা আপনার জিরো-টাচ এনরোলমেন্ট রিসেলার অ্যাকাউন্টের সদস্য। আপনি এখনও অনবোর্ড না করে থাকলে, রিসেলার পোর্টাল গাইড-এ শুরু করুন বিকল্পে গিয়ে ধাপগুলি অনুসরণ করুন।
  • Java 1.7 বা তার পরবর্তী ভার্সন।
  • Gradle 2.3 বা তার পরবর্তী যেকোনও ভার্সন।
  • ইন্টারনেট ও ওয়েব ব্রাউজারে অ্যাক্সেস।

ধাপ ১: জিরো-টাচ এনরোলমেন্ট API চালু করা

  1. Google Developers Console-এ প্রোজেক্ট তৈরি বা বেছে নিতে এবং অটোমেটিক API চালু করতে এই উইজার্ড ব্যবহার করুন। চালিয়ে যান, তারপর ক্রেডেনশিয়ালে যান বিকল্পে ক্লিক করুন।
  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 enrollment
 * 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. আপনার রিসেলার আইডি লাইন থেকে আপনার পার্টনার আইডি নম্বর কপি করুন।

ধাপ ৫: স্যাম্পেল রান করা

ফাইলে স্ক্রিপ্ট রান করতে আপনার অপারেটিং সিস্টেমের সহায়তা নিন। UNIX ও Mac কম্পিউটারে, আপনার টার্মিনালে নিচে উল্লেখ করা কমান্ড রান করুন:

gradle -q run

সমস্যার সমাধান

কুইকস্টার্টের সাথে কী সমস্যা হয়েছে তা আমাদের জানান এবং আমরা তা সমাধান করার চেষ্টা করব। API কল অনুমোদন করতে জিরো-টাচ কীভাবে পরিষেবা অ্যাকাউন্ট ব্যবহার করে তা জানতে, অনুমোদন পড়ুন।

আরও জানুন