দ্রুত শুরু করুন

একটি Go কমান্ড-লাইন অ্যাপ্লিকেশন তৈরি করুন যা অ্যাডমিন SDK API-তে অনুরোধ পাঠায়।

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

এই কুইকস্টার্টটি অথেনটিকেশন এবং অথরাইজেশন ফ্লো-এর কিছু খুঁটিনাটি বিষয় সামলানোর জন্য গুগল ওয়ার্কস্পেসের প্রস্তাবিত এপিআই ক্লায়েন্ট লাইব্রেরি ব্যবহার করে।

উদ্দেশ্য

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

পূর্বশর্ত

• Go- এর সর্বশেষ সংস্করণ।
• গিট- এর সর্বশেষ সংস্করণ।
• একটি গুগল ক্লাউড প্রকল্প ।

• এপিআই অ্যাক্সেস সক্রিয় করা একটি গুগল ওয়ার্কস্পেস ডোমেইন।
• ওই ডোমেইনে অ্যাডমিনিস্ট্রেটর অধিকারসহ একটি গুগল অ্যাকাউন্ট।

আপনার পরিবেশ তৈরি করুন

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

এপিআই সক্রিয় করুন

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

• গুগল ক্লাউড কনসোলে অ্যাডমিন এসডিকে এপিআই (Admin SDK API) সক্রিয় করুন।

  এপিআই সক্রিয় করুন

OAuth সম্মতি স্ক্রিন কনফিগার করুন

আপনি যদি এই কুইকস্টার্টটি সম্পন্ন করতে একটি নতুন গুগল ক্লাউড প্রজেক্ট ব্যবহার করেন, তাহলে OAuth কনসেন্ট স্ক্রিনটি কনফিগার করুন। যদি আপনি আপনার ক্লাউড প্রজেক্টের জন্য এই ধাপটি ইতিমধ্যেই সম্পন্ন করে থাকেন, তাহলে পরবর্তী বিভাগে চলে যান।

1. Google API কনসোলে, > Google Auth প্ল্যাটফর্ম > ব্র্যান্ডিং- এ যান।

   ব্র্যান্ডিং-এ যান

2. আপনি যদি ইতিমধ্যেই Google Auth প্ল্যাটফর্মটি কনফিগার করে থাকেন, তাহলে আপনি Branding , Audience , এবং Data Access- এ নিম্নলিখিত OAuth Consent Screen সেটিংস কনফিগার করতে পারেন। যদি আপনি এমন কোনো বার্তা দেখতে পান যেখানে লেখা আছে ‘Google Auth প্ল্যাটফর্ম এখনও কনফিগার করা হয়নি’ , তাহলে Get Started-এ ক্লিক করুন:
1. 'অ্যাপ ইনফরমেশন'- এর অধীনে 'অ্যাপ নেম' -এ অ্যাপটির জন্য একটি নাম লিখুন।
2. ব্যবহারকারী সহায়তা ইমেল- এ, এমন একটি সহায়তা ইমেল ঠিকানা বেছে নিন যেখানে ব্যবহারকারীরা তাদের সম্মতি সম্পর্কে কোনো প্রশ্ন থাকলে আপনার সাথে যোগাযোগ করতে পারে।
3. পরবর্তী ধাপে যান।
4. Audience-এর অধীনে Internal নির্বাচন করুন।
5. পরবর্তী ধাপে যান।
6. যোগাযোগের তথ্যের অধীনে, একটি ইমেল ঠিকানা লিখুন যেখানে আপনার প্রকল্পের যেকোনো পরিবর্তন সম্পর্কে আপনাকে জানানো যাবে।
7. পরবর্তী ধাপে যান।
8. Finish-এর অধীনে, Google API Services ব্যবহারকারীর ডেটা নীতি পর্যালোচনা করুন এবং যদি আপনি সম্মত হন, তাহলে I agree to the Google API Services: User Data Policy নির্বাচন করুন।
9. চালিয়ে যান-এ ক্লিক করুন।
10. তৈরি করুন- এ ক্লিক করুন।
3. আপাতত, আপনি স্কোপ যোগ করা এড়িয়ে যেতে পারেন। ভবিষ্যতে, যখন আপনি আপনার Google Workspace অর্গানাইজেশনের বাইরে ব্যবহারের জন্য কোনো অ্যাপ তৈরি করবেন, তখন আপনাকে অবশ্যই ইউজার টাইপ (User type) পরিবর্তন করে ‘এক্সটার্নাল’ ( External ) করতে হবে। এরপর আপনার অ্যাপের জন্য প্রয়োজনীয় অথরাইজেশন স্কোপগুলো যোগ করুন। আরও জানতে, সম্পূর্ণ ‘কনফিগার OAuth কনসেন্ট’ (Configure OAuth consent) গাইডটি দেখুন।

একটি ডেস্কটপ অ্যাপ্লিকেশনের জন্য ক্রেডেনশিয়াল অনুমোদন করুন

আপনার অ্যাপে ব্যবহারকারীদের প্রমাণীকরণ করতে এবং তাদের ডেটা অ্যাক্সেস করতে, আপনাকে এক বা একাধিক OAuth 2.0 ক্লায়েন্ট আইডি তৈরি করতে হবে। গুগলের OAuth সার্ভারের কাছে একটি একক অ্যাপকে শনাক্ত করতে ক্লায়েন্ট আইডি ব্যবহৃত হয়। যদি আপনার অ্যাপ একাধিক প্ল্যাটফর্মে চলে, তবে আপনাকে প্রতিটি প্ল্যাটফর্মের জন্য একটি পৃথক ক্লায়েন্ট আইডি তৈরি করতে হবে।

1. গুগল ক্লাউড কনসোলে, > গুগল অথ প্ল্যাটফর্ম > ক্লায়েন্টস- এ যান।

   ক্লায়েন্টদের কাছে যান

2. ক্লায়েন্ট তৈরি করুন -এ ক্লিক করুন।
3. অ্যাপ্লিকেশন টাইপ > ডেস্কটপ অ্যাপ-এ ক্লিক করুন।
4. Name ফিল্ডে ক্রেডেনশিয়ালটির জন্য একটি নাম টাইপ করুন। এই নামটি শুধুমাত্র Google Cloud Console-এ দেখানো হয়।
5. তৈরি করুন- এ ক্লিক করুন।

   নতুন তৈরি করা ক্রেডেনশিয়ালটি "OAuth 2.0 ক্লায়েন্ট আইডি"-এর অধীনে দেখা যায়।

6. ডাউনলোড করা JSON ফাইলটি credentials.json নামে সংরক্ষণ করুন এবং ফাইলটি আপনার ওয়ার্কিং ডিরেক্টরিতে নিয়ে যান।

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

1. একটি ওয়ার্কিং ডিরেক্টরি তৈরি করুন:

   mkdir quickstart
   

2. ওয়ার্কিং ডিরেক্টরিতে পরিবর্তন করুন:

   cd quickstart
   

3. নতুন মডিউলটি শুরু করুন:

   go mod init quickstart
   

4. অ্যাডমিন এসডিকে এপিআই গো ক্লায়েন্ট লাইব্রেরি এবং OAuth2.0 প্যাকেজটি সংগ্রহ করুন:

   go get google.golang.org/api/admin/reports/v1
   go get golang.org/x/oauth2/google
   

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

1. আপনার ওয়ার্কিং ডিরেক্টরিতে quickstart.go নামে একটি ফাইল তৈরি করুন।

2. ফাইলটিতে নিম্নলিখিত কোডটি পেস্ট করুন:

   admin_sdk/reports/quickstart.go

   গিটহাবে দেখুন
   package main
   
   import (
   	"context"
   	"encoding/json"
   	"fmt"
   	"log"
   	"net/http"
   	"os"
   	"time"
   
   	"golang.org/x/oauth2"
   	"golang.org/x/oauth2/google"
   	admin "google.golang.org/api/admin/reports/v1"
   	"google.golang.org/api/option"
   )
   
   // Retrieve a token, saves the token, then returns the generated client.
   func getClient(config *oauth2.Config) *http.Client {
   	// The file token.json stores the user's access and refresh tokens, and is
   	// created automatically when the authorization flow completes for the first
   	// time.
   	tokFile := "token.json"
   	tok, err := tokenFromFile(tokFile)
   	if err != nil {
   		tok = getTokenFromWeb(config)
   		saveToken(tokFile, tok)
   	}
   	return config.Client(context.Background(), tok)
   }
   
   // Request a token from the web, then returns the retrieved token.
   func getTokenFromWeb(config *oauth2.Config) *oauth2.Token {
   	authURL := config.AuthCodeURL("state-token", oauth2.AccessTypeOffline)
   	fmt.Printf("Go to the following link in your browser then type the "+
   		"authorization code: \n%v\n", authURL)
   
   	var authCode string
   	if _, err := fmt.Scan(&authCode); err != nil {
   		log.Fatalf("Unable to read authorization code: %v", err)
   	}
   
   	tok, err := config.Exchange(context.TODO(), authCode)
   	if err != nil {
   		log.Fatalf("Unable to retrieve token from web: %v", err)
   	}
   	return tok
   }
   
   // Retrieves a token from a local file.
   func tokenFromFile(file string) (*oauth2.Token, error) {
   	f, err := os.Open(file)
   	if err != nil {
   		return nil, err
   	}
   	defer f.Close()
   	tok := &oauth2.Token{}
   	err = json.NewDecoder(f).Decode(tok)
   	return tok, err
   }
   
   // Saves a token to a file path.
   func saveToken(path string, token *oauth2.Token) {
   	fmt.Printf("Saving credential file to: %s\n", path)
   	f, err := os.OpenFile(path, os.O_RDWR|os.O_CREATE|os.O_TRUNC, 0600)
   	if err != nil {
   		log.Fatalf("Unable to cache oauth token: %v", err)
   	}
   	defer f.Close()
   	json.NewEncoder(f).Encode(token)
   }
   
   func main() {
   	ctx := context.Background()
   	b, err := os.ReadFile("credentials.json")
   	if err != nil {
   		log.Fatalf("Unable to read client secret file: %v", err)
   	}
   
   	// If modifying these scopes, delete your previously saved token.json.
   	config, err := google.ConfigFromJSON(b, admin.AdminReportsAuditReadonlyScope)
   	if err != nil {
   		log.Fatalf("Unable to parse client secret file to config: %v", err)
   	}
   	client := getClient(config)
   
   	srv, err := admin.NewService(ctx, option.WithHTTPClient(client))
   	if err != nil {
   		log.Fatalf("Unable to retrieve reports Client %v", err)
   	}
   
   	r, err := srv.Activities.List("all", "login").MaxResults(10).Do()
   	if err != nil {
   		log.Fatalf("Unable to retrieve logins to domain. %v", err)
   	}
   
   	if len(r.Items) == 0 {
   		fmt.Println("No logins found.")
   	} else {
   		fmt.Println("Logins:")
   		for _, a := range r.Items {
   			t, err := time.Parse(time.RFC3339Nano, a.Id.Time)
   			if err != nil {
   				fmt.Println("Unable to parse login time.")
   				// Set time to zero.
   				t = time.Time{}
   			}
   			fmt.Printf("%s: %s %s\n", t.Format(time.RFC822), a.Actor.Email,
   				a.Events[0].Name)
   		}
   	}
   }

নমুনাটি চালান

1. আপনার ওয়ার্কিং ডিরেক্টরিতে, স্যাম্পলটি বিল্ড ও রান করুন:

   go run quickstart.go
   

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

   আপনার Go অ্যাপ্লিকেশনটি রান করে এবং অ্যাডমিন SDK API-কে কল করে।

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

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

• এপিআই এক্সপ্লোরারে গুগল ওয়ার্কস্পেস এপিআইগুলো ব্যবহার করে দেখুন।
  • প্রমাণীকরণ এবং অনুমোদন সংক্রান্ত সমস্যা সমাধান করুন
  • অ্যাডমিন এসডিকে রিপোর্ট এপিআই রেফারেন্স ডকুমেন্টেশন
  • গিটহাবের google-api-go-client বিভাগ