API অনুরোধ

আপনার Google APIs ক্লায়েন্ট লাইব্রেরি ফর জাভার জন্য নির্ভরতা ঘোষণা করার জন্য আপনার প্রকল্পটি সেট আপ করার পরে, অনুরোধ করার জন্য এই পদক্ষেপগুলি অনুসরণ করুন। এই পৃষ্ঠার স্নিপেটগুলি ক্লাউড রিসোর্স ম্যানেজার API এর v3 ব্যবহার করে।

ধাপ ১: প্রমাণীকরণ

com.google.auth.oauth2.GoogleCredentials ইনস্ট্যান্সটি ইন্সট্যান্ট করুন। গুগল ক্লাউড ব্যবহারকারীদের জন্য, আপনি অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল পেতে GoogleCredentials.getApplicationDefault() ব্যবহার করতে পারেন।

GoogleCredentials credentials = GoogleCredentials.getApplicationDefault();

প্রমাণীকরণ সম্পর্কে আরও তথ্যের জন্য, Google Auth Library Java দেখুন।

ধাপ ২: সার্ভিস ক্লাস চালু করুন

একটি গুগল সার্ভিসের এক বা একাধিক ভার্সন থাকে। একটি সার্ভিস ক্লাস একটি সার্ভিসের একটি ভার্সনকে প্রতিনিধিত্ব করে এবং এটি AbstractGoogleJsonClient এর একটি চাইল্ড ক্লাস। উদাহরণস্বরূপ com.google.api.services.cloudresourcemanager.v3.CloudResourceManager

সার্ভিস ক্লাসের বিল্ডার ক্লাস 3টি প্যারামিটার নেয়:

আপনার অ্যাপ্লিকেশনের নাম দিয়ে বিল্ডারের setApplicationName() পদ্ধতিটিও কল করুন। এটি অ্যাপ্লিকেশনের নাম দিয়ে UserAgent হেডার সেট করে এবং লগের সমস্যা সমাধানের জন্য সহায়ক।

কোডটি দেখতে এরকম:

HttpTransport transport = new NetHttpTransport();
JsonFactory jsonFactory = GsonFactory.getDefaultInstance();
CloudResourceManager.Builder resourceManagerBuilder =
    new CloudResourceManager.Builder(
        transport, jsonFactory, new HttpCredentialsAdapter(credentials))
        .setApplicationName("Example Java App");
CloudResourceManager cloudResourceManager = resourceManagerBuilder.build();

ধাপ ৩: একটি রিসোর্স অবজেক্ট তৈরি করুন

একটি রিসোর্স ক্লাস একটি পরিষেবা দ্বারা পরিচালিত রিসোর্সের একটি প্রকারকে প্রতিনিধিত্ব করে। ক্লাসটিকে পরিষেবা ক্লাসের একটি অভ্যন্তরীণ ক্লাস হিসাবে সংজ্ঞায়িত করা হয়। আপনি পরিষেবা ক্লাসের পদ্ধতিগুলি ব্যবহার করে এগুলি অ্যাক্সেস করতে পারেন।

উদাহরণস্বরূপ, আপনি CloudResourceManager ক্লাসের "Projects" রিসোর্সটি পেতে পারেন:

import com.google.api.services.cloudresourcemanager.v3.CloudResourceManager.Projects;

...

Projects projects = cloudResourceManager.projects();

ধাপ ৪: একটি অনুরোধ বস্তু তৈরি করুন

রিসোর্স অবজেক্টের বিরুদ্ধে অপারেশনগুলিকে রিকোয়েস্ট ক্লাস হিসেবে উপস্থাপন করা হয়। উপলব্ধ অপারেশনগুলি রিসোর্স ক্লাসের উপর নির্ভর করে। উদাহরণস্বরূপ, "create", "get", এবং "delete" পদ্ধতি প্রদানকারী একটি রিসোর্স ক্লাসে যথাক্রমে "Create", "Get", এবং "Delete" অনুরোধ ক্লাস থাকে।

ক্লাউড রিসোর্স ম্যানেজারের উদাহরণের জন্য, আপনি projects.get পদ্ধতিতে কল করে Get request অবজেক্ট তৈরি করতে পারেন:

Get get = projects.get("projects/your-project-id");

ধাপ ৫: অনুরোধটি কার্যকর করুন

একটি রিকোয়েস্ট অবজেক্টে execute() পদ্ধতি থাকে যা রিকোয়েস্টটি চালায়। এই কলটি গুগল সার্ভিসে একটি HTTP অনুরোধ কার্যকর করে এবং একটি মডেল ক্লাসে JSON প্রতিক্রিয়া ডিসিরিয়ালাইজ করে। উদাহরণস্বরূপ, Get request অবজেক্টের execute() পদ্ধতি একটি প্রজেক্ট অবজেক্ট ফেরত দেয়:

Project project = get.execute();
System.out.println("Project name: " + project.getDisplayName());

সারাংশ

এই ধাপগুলি ব্যবহার করে, আপনি জাভার জন্য Google APIs ক্লায়েন্ট লাইব্রেরি ব্যবহার করে অনুরোধ করতে পারবেন। এখানে কোড স্নিপেট রয়েছে যা রিসোর্স ম্যানেজার পরিষেবা ব্যবহার করে সমস্ত ধাপগুলিকে একত্রিত করে।

package com.example;

import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.http.HttpTransport;
import com.google.api.client.json.JsonFactory;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.cloudresourcemanager.v3.CloudResourceManager;
import com.google.api.services.cloudresourcemanager.v3.CloudResourceManager.Projects;
import com.google.api.services.cloudresourcemanager.v3.CloudResourceManager.Projects.Get;
import com.google.api.services.cloudresourcemanager.v3.model.Project;
import com.google.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;

public class ResourceManagerSample {
  public static void main(String[] arguments) throws Exception {
    GoogleCredentials credentials = GoogleCredentials.getApplicationDefault();

    HttpTransport transport = new NetHttpTransport();
    JsonFactory jsonFactory = GsonFactory.getDefaultInstance();
    CloudResourceManager.Builder resourceManagerBuilder =
        new CloudResourceManager.Builder(
            transport, jsonFactory, new HttpCredentialsAdapter(credentials))
            .setApplicationName("Example Java App");
    CloudResourceManager cloudResourceManager = resourceManagerBuilder.build();

    Projects projects = cloudResourceManager.projects();

    Get get = projects.get("projects/your-project-id");

    Project project = get.execute();
    System.out.println("Project display name: " + project.getDisplayName());
  }
}