জাভা ক্লায়েন্ট লাইব্রেরি দিয়ে শুরু করুন

Java ক্লায়েন্ট লাইব্রেরির সাথে Google Photos Library API ব্যবহার শুরু করতে, আপনাকে আপনার ডেভেলপমেন্ট পরিবেশে ক্লায়েন্ট লাইব্রেরি সেট আপ করতে হবে। আপনি এটি করার আগে, Google API কনসোলের মাধ্যমে API সক্ষম করে এবং একটি OAuth 2.0 ক্লায়েন্ট আইডি সেট আপ করে আপনার প্রকল্পটি কনফিগার করুন

আপনার অ্যাপ্লিকেশনটি Google Photos ব্যবহারকারীর হয়ে Google Photos-এর সাথে ইন্টারঅ্যাক্ট করে। উদাহরণস্বরূপ, আপনি যখন কোনো ব্যবহারকারীর Google Photos লাইব্রেরিতে অ্যালবাম তৈরি করেন বা কোনো ব্যবহারকারীর Google Photos অ্যাকাউন্টে মিডিয়া আইটেম আপলোড করেন, তখন ব্যবহারকারী OAuth 2.0 প্রোটোকলের মাধ্যমে এই API অনুরোধগুলি অনুমোদন করে।

OAuth 2.0 ক্লায়েন্ট আইডি আপনার অ্যাপ্লিকেশন ব্যবহারকারীদের সাইন ইন, প্রমাণীকরণ এবং এর মাধ্যমে লাইব্রেরি API ব্যবহার করার অনুমতি দেয়। লাইব্রেরি API পরিষেবা অ্যাকাউন্ট সমর্থন করে না; এই API ব্যবহার করতে, ব্যবহারকারীদের অবশ্যই একটি বৈধ Google অ্যাকাউন্টে সাইন ইন করতে হবে৷

আপনার অ্যাপ কনফিগার করুন

API সক্ষম করুন

আপনি লাইব্রেরি API ব্যবহার করার আগে, আপনাকে অবশ্যই আপনার প্রকল্পের জন্য এটি সক্ষম করতে হবে৷

  1. Google API কনসোলে যান।
  2. মেনু বার থেকে, একটি প্রকল্প নির্বাচন করুন বা একটি নতুন প্রকল্প তৈরি করুন৷
  3. Google API লাইব্রেরি খুলতে, নেভিগেশন মেনু থেকে, APIs & Services > Library নির্বাচন করুন।
  4. "Google Photos Library API" অনুসন্ধান করুন। সঠিক ফলাফল নির্বাচন করুন এবং সক্রিয় ক্লিক করুন।

একটি OAuth 2.0 ক্লায়েন্ট আইডি অনুরোধ করুন

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

  1. Google API কনসোলে যান এবং আপনার প্রকল্প নির্বাচন করুন।
  2. মেনু থেকে, APIs & Services > Credentials নির্বাচন করুন।
  3. শংসাপত্র পৃষ্ঠায়, শংসাপত্র তৈরি করুন > OAuth ক্লায়েন্ট আইডি ক্লিক করুন।
  4. আপনার আবেদনের ধরন নির্বাচন করুন। এই উদাহরণে, অ্যাপ্লিকেশনের ধরন হল ওয়েব অ্যাপ্লিকেশন
  5. যেখান থেকে আপনার অ্যাপকে Google API গুলি অ্যাক্সেস করার অনুমতি দেওয়া হয়েছে তা নিম্নরূপ নিবন্ধন করুন:

    1. ক্লায়েন্ট আইডি সনাক্ত করতে, একটি নাম লিখুন।
    2. অনুমোদিত জাভাস্ক্রিপ্ট অরিজিন ফিল্ডে, আপনার অ্যাপের মূল লিখুন। এই ক্ষেত্রটি ওয়াইল্ডকার্ডের অনুমতি দেয় না।

      আপনার অ্যাপটিকে বিভিন্ন প্রোটোকল, ডোমেন বা সাবডোমেনে চালানোর অনুমতি দিতে আপনি একাধিক অরিজিন লিখতে পারেন। আপনি যে URLগুলি লিখছেন সেগুলিকে একটি OAuth অনুরোধ শুরু করার অনুমতি দেওয়া হয়েছে৷

      নিম্নলিখিত উদাহরণ একটি স্থানীয় উন্নয়ন URL (আমাদের নমুনা localhost:8080 ) এবং একটি উত্পাদন URL দেখায়।

      http://localhost:8080
      https://myproductionurl.example.com
      
    3. অনুমোদিত পুনঃনির্দেশ URI ক্ষেত্র হল শেষ পয়েন্ট যা OAuth 2.0 সার্ভার থেকে প্রতিক্রিয়া গ্রহণ করে। সাধারণত, এটি আপনার বিকাশের পরিবেশকে অন্তর্ভুক্ত করে এবং আপনার অ্যাপ্লিকেশনে একটি পথ নির্দেশ করে।

      http://localhost:8080/auth/google/callback
      https://myproductionurl.example.com/auth/google/callback
      
    4. তৈরি করুন ক্লিক করুন।

  1. ফলস্বরূপ OAuth ক্লায়েন্ট ডায়ালগ থেকে, আপনার ক্লায়েন্ট কনফিগারেশন ধারণকারী JSON ফাইলটি ডাউনলোড করুন। আপনার ক্লায়েন্টের বিবরণ নিম্নলিখিতগুলি নিয়ে গঠিত:

    • ক্লায়েন্ট আইডি
    • ক্লায়েন্ট গোপন

    এই JSON ফাইলটি পরে Java এর জন্য Google Auth লাইব্রেরি সেট আপ করতে ব্যবহার করা হবে যা এই ক্লায়েন্ট লাইব্রেরির সাথে কাজ করে৷

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

ক্লায়েন্ট লাইব্রেরি সেট আপ করুন

জাভা ক্লায়েন্ট লাইব্রেরি আপনার জন্য সমস্ত ব্যাকএন্ড API কল পরিচালনা করে এবং কিছু সাধারণ API কাজের জন্য কোড নমুনা সহ কাজ করার জন্য বন্ধুত্বপূর্ণ বস্তুগুলিকে প্রকাশ করে। প্রথমত, GitHub থেকে নির্ভরতা সহ Java এর জন্য Google Photos Library API ক্লায়েন্ট লাইব্রেরি ডাউনলোড এবং ইনস্টল করুন। তারপর, Java এর জন্য আপনার OAuth2 শংসাপত্র সেট আপ করুন৷

ডাউনলোড অপশন

ক্লায়েন্ট লাইব্রেরি ডাউনলোড করার জন্য এখানে কিছু বিকল্প রয়েছে:

  • গ্রেডেল নির্ভরতা:

    Gradle এর সাথে এই লাইব্রেরিটি ব্যবহার করতে, আপনার build.gradle ফাইলে নিম্নলিখিত নির্ভরতা যোগ করুন।

    repositories {
      mavenCentral()
    }
    dependencies {
      compile 'com.google.photos.library:google-photos-library-client:1.7.3'
    }
    
  • মাভেন নির্ভরতা:

    Maven এর সাথে এই লাইব্রেরিটি ব্যবহার করতে, আপনার Maven pom.xml ফাইলে নিম্নলিখিত যোগ করুন।

    <dependency>
      <groupId>com.google.photos.library</groupId>
      <artifactId>google-photos-library-client</artifactId>
      <version>1.7.3</version>
    </dependency>
    
  • একটি রিলিজ ডাউনলোড করুন:

    রিলিজ পৃষ্ঠায় জার ফাইল সহ প্রতিটি লাইব্রেরি রিলিজের জন্য বিভিন্ন শিল্পকর্ম রয়েছে।

  • সংগ্রহস্থল ক্লোন করুন:

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

    1. কমান্ড প্রম্পটে git clone https://github.com/google/java-photoslibrary.git চালান।
    2. আপনি একটি java-photoslibrary ডিরেক্টরি পাবেন। cd java-photoslibrary চালিয়ে এটিতে নেভিগেট করুন।
    3. আপনার IDE-তে build.gradle ফাইলটি খুলুন বা প্রজেক্ট তৈরি করতে কমান্ড প্রম্পটে ./gradlew assemble চালান। উপলব্ধ কাজগুলি দেখতে ./gradlew tasks দেখুন৷

Java এর জন্য আপনার OAuth2 শংসাপত্র সেট আপ করুন৷

এই ক্লায়েন্ট লাইব্রেরিটি Java এর জন্য Google Auth Library এর সাথে কাজ করে। আরও তথ্যের জন্য, Java এর জন্য Google API ক্লায়েন্ট লাইব্রেরির সাথে OAuth 2.0 ব্যবহার করুন দেখুন।

একটি PhotosLibraryClient অবজেক্টের জন্য PhotoLibrarySettings তৈরি করার সময় CredentialsProvider এ আপনার ক্লায়েন্ট OAuth কনফিগারেশন নির্দিষ্ট করুন।

কিছু নমুনা চেষ্টা করুন

Java ক্লায়েন্ট লাইব্রেরি ব্যবহার করে আপনার প্রথম API কল করতে নীচের কোডটি চেষ্টা করুন।

// Set up the Photos Library Client that interacts with the API
PhotosLibrarySettings settings =
     PhotosLibrarySettings.newBuilder()
    .setCredentialsProvider(
        FixedCredentialsProvider.create(/* Add credentials here. */)) 
    .build();

try (PhotosLibraryClient photosLibraryClient =
    PhotosLibraryClient.initialize(settings)) {

    // Create a new Album  with at title
    Album createdAlbum = photosLibraryClient.createAlbum("My Album");

    // Get some properties from the album, such as its ID and product URL
    String id = album.getId();
    String url = album.getProductUrl();

} catch (ApiException e) {
    // Error during album creation
}

আপনার চেষ্টা করার জন্য GitHub-এ আরও নমুনা রয়েছে।