জাভা কুইকস্টার্ট

কুইকস্টার্ট ব্যাখ্যা করে যে কীভাবে একটি অ্যাপ সেট আপ করতে হয় এবং চালাতে হয় যেটি একটি Google Workspace API কল করে।

প্রমাণীকরণ এবং অনুমোদনের প্রবাহের কিছু বিবরণ পরিচালনা করতে Google Workspace কুইকস্টার্ট এপিআই ক্লায়েন্ট লাইব্রেরি ব্যবহার করে। আমরা সুপারিশ করি যে আপনি আপনার নিজের অ্যাপের জন্য ক্লায়েন্ট লাইব্রেরি ব্যবহার করুন। এই কুইকস্টার্ট একটি সরলীকৃত প্রমাণীকরণ পদ্ধতি ব্যবহার করে যা একটি পরীক্ষার পরিবেশের জন্য উপযুক্ত। একটি উত্পাদন পরিবেশের জন্য, আমরা আপনার অ্যাপের জন্য উপযুক্ত অ্যাক্সেসের শংসাপত্রগুলি বেছে নেওয়ার আগে প্রমাণীকরণ এবং অনুমোদন সম্পর্কে শেখার পরামর্শ দিই৷

একটি জাভা কমান্ড-লাইন অ্যাপ্লিকেশন তৈরি করুন যা Google Keep API-কে অনুরোধ করে।

উদ্দেশ্য

  • আপনার পরিবেশ সেট আপ করুন।
  • নমুনা সেট আপ করুন।
  • নমুনা চালান।

পূর্বশর্ত

  • Google Keep এর সাথে একটি Google অ্যাকাউন্ট চালু আছে।

আপনার পরিবেশ সেট আপ করুন

এই কুইকস্টার্ট সম্পূর্ণ করতে, আপনার পরিবেশ সেট আপ করুন।

API সক্ষম করুন

Google API ব্যবহার করার আগে, আপনাকে একটি Google ক্লাউড প্রকল্পে সেগুলি চালু করতে হবে। আপনি একটি একক Google ক্লাউড প্রকল্পে এক বা একাধিক API চালু করতে পারেন৷

একটি পরিষেবা অ্যাকাউন্ট তৈরি করুন

একটি পরিষেবা অ্যাকাউন্ট হল একটি বিশেষ ধরনের অ্যাকাউন্ট যা কোনো ব্যক্তির পরিবর্তে একটি অ্যাপ্লিকেশন দ্বারা ব্যবহৃত হয়। আপনি ডেটা অ্যাক্সেস করতে বা রোবট অ্যাকাউন্টের মাধ্যমে ক্রিয়া সম্পাদন করতে বা Google Workspace বা Cloud Identity ব্যবহারকারীদের হয়ে ডেটা অ্যাক্সেস করতে একটি পরিষেবা অ্যাকাউন্ট ব্যবহার করতে পারেন। আরও তথ্যের জন্য, পরিষেবা অ্যাকাউন্ট বোঝার দেখুন।

গুগল ক্লাউড কনসোল

  1. Google ক্লাউড কনসোলে, মেনু > IAM & Admin > Service Accounts- এ যান।

    সার্ভিস অ্যাকাউন্টে যান

  2. পরিষেবা অ্যাকাউন্ট তৈরি করুন ক্লিক করুন।
  3. পরিষেবা অ্যাকাউন্টের বিবরণ পূরণ করুন, তারপর তৈরি করুন এবং চালিয়ে যান ক্লিক করুন।
  4. ঐচ্ছিক: আপনার Google ক্লাউড প্রকল্পের সংস্থানগুলিতে অ্যাক্সেস দেওয়ার জন্য আপনার পরিষেবা অ্যাকাউন্টে ভূমিকা বরাদ্দ করুন৷ আরও বিশদ বিবরণের জন্য, সংস্থানগুলিতে অ্যাক্সেস মঞ্জুর করা, পরিবর্তন করা এবং প্রত্যাহার করা দেখুন।
  5. অবিরত ক্লিক করুন.
  6. ঐচ্ছিক: ব্যবহারকারী বা গোষ্ঠীগুলি লিখুন যারা এই পরিষেবা অ্যাকাউন্টের সাথে ক্রিয়াকলাপ পরিচালনা এবং সম্পাদন করতে পারে৷ আরও বিশদ বিবরণের জন্য, পরিসেবা অ্যাকাউন্ট ছদ্মবেশ ম্যানেজিং দেখুন।
  7. সম্পন্ন ক্লিক করুন. পরিষেবা অ্যাকাউন্টের জন্য ইমেল ঠিকানা একটি নোট করুন.

জিক্লাউড সিএলআই

  1. পরিষেবা অ্যাকাউন্ট তৈরি করুন: 
    gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
  --display-name="SERVICE_ACCOUNT_NAME"
  2. ঐচ্ছিক: আপনার Google ক্লাউড প্রকল্পের সংস্থানগুলিতে অ্যাক্সেস দেওয়ার জন্য আপনার পরিষেবা অ্যাকাউন্টে ভূমিকা বরাদ্দ করুন৷ আরও বিশদ বিবরণের জন্য, সংস্থানগুলিতে অ্যাক্সেস মঞ্জুর করা, পরিবর্তন করা এবং প্রত্যাহার করা দেখুন।

একটি পরিষেবা অ্যাকাউন্টের জন্য শংসাপত্র তৈরি করুন

আপনাকে একটি পাবলিক/প্রাইভেট কী জোড়া আকারে শংসাপত্র প্রাপ্ত করতে হবে। এই শংসাপত্রগুলি আপনার কোড দ্বারা আপনার অ্যাপের মধ্যে পরিষেবা অ্যাকাউন্ট ক্রিয়াগুলি অনুমোদন করতে ব্যবহার করা হয়৷
  1. Google ক্লাউড কনসোলে, মেনু > IAM & Admin > Service Accounts- এ যান।

    সার্ভিস অ্যাকাউন্টে যান

  2. আপনার পরিষেবা অ্যাকাউন্ট নির্বাচন করুন.
  3. কী > কী যোগ করুন > নতুন কী তৈরি করুন ক্লিক করুন।
  4. JSON নির্বাচন করুন, তারপর তৈরি করুন ক্লিক করুন।

    আপনার নতুন পাবলিক/প্রাইভেট কী জোড়া তৈরি করা হয়েছে এবং একটি নতুন ফাইল হিসেবে আপনার মেশিনে ডাউনলোড করা হয়েছে। ডাউনলোড করা JSON ফাইলটিকে আপনার কাজের ডিরেক্টরিতে credentials.json হিসাবে সংরক্ষণ করুন। এই ফাইলটি এই কীটির একমাত্র অনুলিপি। কীভাবে আপনার কী নিরাপদে সংরক্ষণ করবেন সে সম্পর্কে তথ্যের জন্য, পরিষেবা অ্যাকাউন্ট কীগুলি পরিচালনা করা দেখুন।

  5. বন্ধ ক্লিক করুন.

একটি পরিষেবা অ্যাকাউন্টের জন্য ডোমেন-ওয়াইড ডেলিগেশন সেট আপ করুন৷

Google Workspace সংস্থার ব্যবহারকারীদের হয়ে API-কে কল করার জন্য, আপনার পরিষেবা অ্যাকাউন্টকে একটি সুপার অ্যাডমিনিস্ট্রেটর অ্যাকাউন্টের মাধ্যমে Google Workspace অ্যাডমিন কনসোলে ডোমেন-ওয়াইড অথরিটি মঞ্জুর করতে হবে। আরও তথ্যের জন্য, একটি পরিষেবা অ্যাকাউন্টে ডোমেইন-ওয়াইড অথরিটি অর্পণ করা দেখুন।
  1. Google ক্লাউড কনসোলে, মেনু > IAM & Admin > Service Accounts- এ যান।

    সার্ভিস অ্যাকাউন্টে যান

  2. আপনার পরিষেবা অ্যাকাউন্ট নির্বাচন করুন.
  3. অ্যাডভান্সড সেটিংস দেখান ক্লিক করুন।
  4. "ডোমেন-ওয়াইড ডেলিগেশন"-এর অধীনে আপনার পরিষেবা অ্যাকাউন্টের "ক্লায়েন্ট আইডি" খুঁজুন। আপনার ক্লিপবোর্ডে ক্লায়েন্ট আইডি মান অনুলিপি করতে কপি ক্লিক করুন।

  5. প্রাসঙ্গিক Google Workspace অ্যাকাউন্টে আপনার সুপার অ্যাডমিনিস্ট্রেটরের অ্যাক্সেস থাকলে, Google Workspace অ্যাডমিন কনসোল দেখুন-এ ক্লিক করুন, তারপর একটি সুপার অ্যাডমিনিস্ট্রেটর ব্যবহারকারী অ্যাকাউন্ট ব্যবহার করে সাইন-ইন করুন এবং এই ধাপগুলি অনুসরণ করা চালিয়ে যান।

    প্রাসঙ্গিক Google Workspace অ্যাকাউন্টে আপনার সুপার অ্যাডমিনিস্ট্রেটরের অ্যাক্সেস না থাকলে, সেই অ্যাকাউন্টের জন্য একজন সুপার অ্যাডমিনিস্ট্রেটরের সাথে যোগাযোগ করুন এবং তাদের আপনার পরিষেবা অ্যাকাউন্টের ক্লায়েন্ট আইডি এবং OAuth স্কোপের তালিকা পাঠান যাতে তারা অ্যাডমিন কনসোলে নিম্নলিখিত ধাপগুলি সম্পূর্ণ করতে পারে।

    1. Google অ্যাডমিন কনসোলে, মেনু > নিরাপত্তা > অ্যাক্সেস এবং ডেটা নিয়ন্ত্রণ > API নিয়ন্ত্রণগুলিতে যান।

      API নিয়ন্ত্রণে যান

    2. ডোমেন ওয়াইড ডেলিগেশন পরিচালনা করুন ক্লিক করুন।
    3. নতুন যোগ করুন ক্লিক করুন.
    4. "ক্লায়েন্ট আইডি" ক্ষেত্রে, ক্লায়েন্ট আইডি পেস্ট করুন যা আপনি আগে কপি করেছেন।
    5. "OAuth স্কোপস" ক্ষেত্রে, আপনার আবেদনের জন্য প্রয়োজনীয় স্কোপের একটি কমা-ডিলিমিটেড তালিকা লিখুন। OAuth সম্মতি স্ক্রীন কনফিগার করার সময় আপনি সংজ্ঞায়িত স্কোপের একই সেট।
    6. অনুমোদন ক্লিক করুন.

কর্মক্ষেত্র প্রস্তুত করুন

  1. আপনার কাজের ডিরেক্টরিতে, একটি নতুন প্রকল্প কাঠামো তৈরি করুন:

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

  2. src/main/resources/ ডিরেক্টরিতে, আপনি পূর্বে ডাউনলোড করা credentials.json ফাইলটি কপি করুন।

  3. ডিফল্ট build.gradle ফাইলটি খুলুন এবং নিম্নলিখিত কোড দিয়ে এর বিষয়বস্তু প্রতিস্থাপন করুন: 

      apply plugin: 'java'
apply plugin: 'application'

mainClassName = 'KeepQuickstart'
sourceCompatibility = 1.8
targetCompatibility = 1.8
version = '1.0'

sourceCompatibility = 1.8

repositories {
    mavenCentral()
}

dependencies {
    implementation 'com.google.api-client:google-api-client:1.23.0'
    implementation 'com.google.oauth-client:google-oauth-client-jetty:1.23.0'
    implementation 'com.google.apis:google-api-services-keep:v1-rev20210528-1.31.0'
}

নমুনা সেট আপ করুন

  1. src/main/java/ ডিরেক্টরিতে, একটি নাম দিয়ে একটি নতুন জাভা ফাইল তৈরি করুন যা আপনার build.gradle ফাইলের mainClassName মানের সাথে মেলে।

  2. আপনার নতুন জাভা ফাইলে নিম্নলিখিত কোড অন্তর্ভুক্ত করুন: 

    import com.google.api.client.auth.oauth2.Credential;
import com.google.api.client.extensions.java6.auth.oauth2.AuthorizationCodeInstalledApp;
import com.google.api.client.extensions.jetty.auth.oauth2.LocalServerReceiver;
import com.google.api.client.googleapis.auth.oauth2.GoogleAuthorizationCodeFlow;
import com.google.api.client.googleapis.auth.oauth2.GoogleClientSecrets;
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.JsonFactory;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.client.util.store.FileDataStoreFactory;
import com.google.api.services.keep.v1.Keep;
import com.google.api.services.keep.v1.model.Note;
import com.google.api.services.keep.v1.model.Section;
import com.google.api.services.keep.v1.model.TextContent;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.security.GeneralSecurityException;
import java.util.Collections;
import java.util.List;

public class KeepQuickstart {

  private static final String APPLICATION_NAME = "Google Keep API Java Quickstart";
  private static final JsonFactory JSON_FACTORY = GsonFactory.getDefaultInstance();

  /**
   * Global instance of the scopes required by this quickstart. If modifying these scopes, delete
   * your previously saved tokens/ folder.
   */
  private static final List<String> KEEP_SCOPES =
      Collections.singletonList("https://www.googleapis.com/auth/keep");

  private static final String CREDENTIALS_FILE_PATH = "/credentials.json";

  /**
   * Creates an authorized Credential object.
   *
   * @param HTTP_TRANSPORT The network HTTP Transport.
   * @return An authorized Credential object.
   * @throws IOException
   */
  private static Credential getOAuthCredentials(final NetHttpTransport HTTP_TRANSPORT)
      throws IOException {
    // Load client secrets.
    InputStream in = KeepQuickstart.class.getResourceAsStream(CREDENTIALS_FILE_PATH);
    if (in == null) {
      throw new FileNotFoundException("Resource not found: " + CREDENTIALS_FILE_PATH);
    }
    GoogleClientSecrets clientSecrets =
        GoogleClientSecrets.load(JSON_FACTORY, new InputStreamReader(in));

    // Build flow and trigger user authorization request.
    GoogleAuthorizationCodeFlow flow =
        new GoogleAuthorizationCodeFlow.Builder(
                HTTP_TRANSPORT, JSON_FACTORY, clientSecrets, KEEP_SCOPES)
            .setDataStoreFactory(new FileDataStoreFactory(new java.io.File("tokens")))
            .setAccessType("offline")
            .build();
    LocalServerReceiver receiver = new LocalServerReceiver.Builder().setPort(8888).build();
    return new AuthorizationCodeInstalledApp(flow, receiver).authorize("user");
  }

  public static void main(String... args) throws IOException, GeneralSecurityException {
    // Build a new authorized API client service.
    final NetHttpTransport HTTP_TRANSPORT = GoogleNetHttpTransport.newTrustedTransport();
    Keep service =
        new Keep.Builder(HTTP_TRANSPORT, JSON_FACTORY, getOAuthCredentials(HTTP_TRANSPORT))
            .setApplicationName(APPLICATION_NAME)
            .build();

    Section noteBody =
        new Section().setText(new TextContent().setText("Finish preparations by tomorrow!"));
    Note newNote = new Note().setTitle("Customer call next week").setBody(noteBody);

    // Creates a new text note.
    service.notes().create(newNote).execute();
  }
}

নমুনা চালান

  1. নমুনা চালান:

    gradle run
  1. আপনি যখন প্রথমবার নমুনা চালান, এটি আপনাকে অ্যাক্সেস অনুমোদন করতে অনুরোধ করে:
    1. আপনি যদি ইতিমধ্যে আপনার Google অ্যাকাউন্টে সাইন ইন না করে থাকেন, প্রম্পট করা হলে সাইন ইন করুন৷ আপনি একাধিক অ্যাকাউন্টে সাইন ইন করে থাকলে, অনুমোদনের জন্য ব্যবহার করার জন্য একটি অ্যাকাউন্ট নির্বাচন করুন।
    2. স্বীকার করুন ক্লিক করুন.

    আপনার জাভা অ্যাপ্লিকেশন চালায় এবং Google Keep API কল করে।

    অনুমোদনের তথ্য ফাইল সিস্টেমে সংরক্ষণ করা হয়, তাই পরের বার যখন আপনি নমুনা কোডটি চালাবেন, তখন আপনাকে অনুমোদনের জন্য অনুরোধ করা হবে না।

পরবর্তী পদক্ষেপ