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

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

পূর্বশর্ত

এই কুইকস্টার্ট চালানোর জন্য আপনার প্রয়োজন হবে:

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

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

1. Google বিকাশকারী কনসোলে একটি প্রকল্প তৈরি বা নির্বাচন করতে এবং স্বয়ংক্রিয়ভাবে API চালু করতে এই উইজার্ডটি ব্যবহার করুন৷ Continue-এ ক্লিক করুন, তারপর শংসাপত্রে যান ।
2. সেট আপনি কি ডেটা অ্যাক্সেস করা হবে? অ্যাপ্লিকেশন ডেটাতে ।
3. পরবর্তী ক্লিক করুন. আপনাকে একটি পরিষেবা অ্যাকাউন্ট তৈরি করতে বলা উচিত।
4. পরিষেবা অ্যাকাউন্ট নামের জন্য একটি বর্ণনামূলক নাম দিন।
5. পরিষেবা অ্যাকাউন্ট আইডি নোট করুন (এটি একটি ইমেল ঠিকানার মতো দেখাচ্ছে) কারণ আপনি এটি পরে ব্যবহার করবেন৷
6. পরিষেবা অ্যাকাউন্টে ভূমিকা সেট করুন > পরিষেবা অ্যাকাউন্ট ব্যবহারকারী ।
7. পরিষেবা অ্যাকাউন্ট তৈরি করা শেষ করতে সম্পন্ন ক্লিক করুন।
8. আপনার তৈরি করা পরিষেবা অ্যাকাউন্টের ইমেল ঠিকানাটিতে ক্লিক করুন।
9. **কী** এ ক্লিক করুন।
10. **কী যোগ করুন** ক্লিক করুন, তারপর **নতুন কী তৈরি করুন** এ ক্লিক করুন।
11. **কী প্রকার** এর জন্য, **JSON** নির্বাচন করুন।
12. তৈরি করুন এবং আপনার কম্পিউটারে ব্যক্তিগত কী ডাউনলোড ক্লিক করুন।
13. **ক্লোজ** এ ক্লিক করুন।
14. ফাইলটিকে আপনার ওয়ার্কিং ডাইরেক্টরিতে নিয়ে যান এবং এর নাম পরিবর্তন করুন service_account_key.json ।

সতর্কতা: যত্ন সহকারে পরিচালিত না হলে পরিষেবা অ্যাকাউন্ট কীগুলি নিরাপত্তা ঝুঁকিতে পরিণত হতে পারে। পরামর্শের জন্য API কীগুলি পরিচালনার জন্য সেরা অনুশীলনগুলি দেখুন।

ধাপ 2: পরিষেবা অ্যাকাউন্ট লিঙ্ক করুন

1. জিরো-টাচ এনরোলমেন্ট পোর্টাল খুলুন। আপনাকে সাইন ইন করতে হতে পারে।
2. পরিষেবা অ্যাকাউন্টে ক্লিক করুন।
3. লিঙ্ক পরিষেবা অ্যাকাউন্ট ক্লিক করুন.
4. আপনার তৈরি পরিষেবা অ্যাকাউন্টের ঠিকানায় ইমেল ঠিকানা সেট করুন।
5. আপনার জিরো-টাচ এনরোলমেন্ট অ্যাকাউন্টের সাথে পরিষেবা অ্যাকাউন্ট ব্যবহার করতে পরিষেবা অ্যাকাউন্ট লিঙ্ক করুন- এ ক্লিক করুন।

ধাপ 3: প্রকল্প প্রস্তুত করুন

আপনার Gradle প্রকল্প সেট আপ করতে নীচের পদক্ষেপগুলি অনুসরণ করুন:

1. কাজের ডিরেক্টরিতে একটি নতুন প্রকল্প তৈরি করতে নিম্নলিখিত কমান্ডটি চালান:

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

2. আপনার উপরে তৈরি করা src/main/resources/ ডিরেক্টরিতে ধাপ 1-এ ডাউনলোড করা service_account_key.json ফাইলটি কপি করুন।

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 (অ্যাপের প্রথম লাইন) এর মান হিসাবে আপনার নিজস্ব রিসেলার অংশীদার 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: নমুনা চালান

ফাইলটিতে স্ক্রিপ্ট চালানোর জন্য আপনার অপারেটিং সিস্টেমের সাহায্য ব্যবহার করুন। ইউনিক্স এবং ম্যাক কম্পিউটারে, আপনার টার্মিনালে নীচের কমান্ডটি চালান:

gradle -q run

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

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

আরও জানুন

• Google Developers Console সহায়তা ডকুমেন্টেশন
• জাভা ডকুমেন্টেশনের জন্য Google APIs ক্লায়েন্ট
• Google APIs ক্লায়েন্ট Javadocs