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

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

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

এই কুইকস্টার্টটি প্রমাণীকরণ এবং অনুমোদন প্রবাহের কিছু বিবরণ পরিচালনা করতে Google Workspace-এর প্রস্তাবিত API ক্লায়েন্ট লাইব্রেরি ব্যবহার করে।

উদ্দেশ্য

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

পূর্বশর্ত

• জাভা ১১ বা তার বেশি।
• গ্রেডল ৭.০ বা তার বেশি ।
• একটি গুগল ক্লাউড প্রকল্প ।

• Google Keep সক্ষম থাকা একটি Google অ্যাকাউন্ট।

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

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

API সক্রিয় করুন

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

• গুগল ক্লাউড কনসোলে, গুগল কিপ এপিআই সক্ষম করুন।

  API সক্রিয় করুন

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

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

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

1. গুগল ক্লাউড কনসোলে, মেনু > IAM & Admin > পরিষেবা অ্যাকাউন্ট এ যান।

   পরিষেবা অ্যাকাউন্টগুলিতে যান।

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

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

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

   gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
     --display-name="SERVICE_ACCOUNT_NAME"

2. ঐচ্ছিক: আপনার Google ক্লাউড প্রোজেক্টের রিসোর্সে অ্যাক্সেস দেওয়ার জন্য আপনার পরিষেবা অ্যাকাউন্টে ভূমিকা নির্ধারণ করুন। আরও বিস্তারিত জানার জন্য, রিসোর্সে অ্যাক্সেস প্রদান, পরিবর্তন এবং প্রত্যাহার দেখুন।

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

আপনাকে একটি পাবলিক/প্রাইভেট কী জোড়ার আকারে শংসাপত্র পেতে হবে। এই শংসাপত্রগুলি আপনার কোড দ্বারা আপনার অ্যাপের মধ্যে পরিষেবা অ্যাকাউন্টের ক্রিয়াকলাপ অনুমোদনের জন্য ব্যবহৃত হয়।

1. গুগল ক্লাউড কনসোলে, মেনু > IAM & Admin > পরিষেবা অ্যাকাউন্ট এ যান।

   পরিষেবা অ্যাকাউন্টগুলিতে যান।

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

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

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

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

কোনও Google Workspace প্রতিষ্ঠানের ব্যবহারকারীদের পক্ষ থেকে API কল করার জন্য, আপনার পরিষেবা অ্যাকাউন্টকে একটি সুপার অ্যাডমিনিস্ট্রেটর অ্যাকাউন্ট দ্বারা Google Workspace অ্যাডমিন কনসোলে ডোমেন-ওয়াইড অথরিটি ডেলিগেশন অফ অথরিটি প্রদান করতে হবে। আরও তথ্যের জন্য, একটি পরিষেবা অ্যাকাউন্টে ডোমেন-ওয়াইড অথরিটি ডেলিগেশন দেখুন।

1. গুগল ক্লাউড কনসোলে, মেনু > IAM & Admin > পরিষেবা অ্যাকাউন্ট এ যান।

   পরিষেবা অ্যাকাউন্টগুলিতে যান।

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

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

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

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

   API নিয়ন্ত্রণগুলিতে যান

2. ডোমেন ওয়াইড ডেলিগেশন পরিচালনা করুন ক্লিক করুন।
3. নতুন যোগ করুন ক্লিক করুন।
4. "ক্লায়েন্ট আইডি" ক্ষেত্রে, আপনার পূর্বে কপি করা ক্লায়েন্ট আইডিটি পেস্ট করুন।
5. "OAuth Scopes" ক্ষেত্রে, আপনার অ্যাপ্লিকেশনের জন্য প্রয়োজনীয় স্কোপের একটি কমা-বিভাজিত তালিকা লিখুন। এটি হল 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
   

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

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

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

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

• API এক্সপ্লোরারে Google Workspace API গুলি ব্যবহার করে দেখুন
• প্রমাণীকরণ এবং অনুমোদন সংক্রান্ত সমস্যা সমাধান করুন
• গুগল কিপ এপিআই রেফারেন্স ডকুমেন্টেশন
• জাভা ডকুমেন্টেশনের জন্য গুগল এপিআই ক্লায়েন্ট
• গুগল কিপ এপিআই জাভাডোক ডকুমেন্টেশন