এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

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

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

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

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

উদ্দেশ্য

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

পূর্বশর্ত

Go এর সর্বশেষ সংস্করণ।
Git এর সর্বশেষ সংস্করণ।
একটি Google ক্লাউড প্রকল্প ।

API অ্যাক্সেস সক্ষম সহ একটি Google Workspace ডোমেন।
প্রশাসকের বিশেষাধিকার সহ সেই ডোমেনে একটি Google অ্যাকাউন্ট।

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

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

API সক্ষম করুন

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

Google ক্লাউড কনসোলে, অ্যাডমিন SDK API সক্ষম করুন৷
API সক্ষম করুন

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

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

Google ক্লাউড কনসোলে, মেনু > এ যান > ব্র্যান্ডিং ।
ব্র্যান্ডিং এ যান
আপনি যদি ইতিমধ্যেই কনফিগার করে থাকেন , আপনি ব্র্যান্ডিং , দর্শক এবং ডেটা অ্যাক্সেসে নিম্নলিখিত OAuth সম্মতি স্ক্রীন সেটিংস কনফিগার করতে পারেন৷ আপনি যদি একটি বার্তা দেখতে পারেন যা বলে এখনো কনফিগার করা হয়নি , Get Started এ ক্লিক করুন:

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

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

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

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

Google ক্লাউড কনসোলে, মেনু > এ যান > ক্লায়েন্ট ।
ক্লায়েন্টে যান
ক্লায়েন্ট তৈরি করুন ক্লিক করুন।
Application type > Desktop app এ ক্লিক করুন।
নাম ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি শুধুমাত্র Google ক্লাউড কনসোলে দেখানো হয়।
তৈরি করুন ক্লিক করুন।
নতুন তৈরি শংসাপত্র "OAuth 2.0 ক্লায়েন্ট IDs" এর অধীনে প্রদর্শিত হবে৷
ডাউনলোড করা JSON ফাইলটিকে credentials.json হিসাবে সংরক্ষণ করুন এবং ফাইলটিকে আপনার কার্যকারী ডিরেক্টরিতে সরান৷

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

একটি কাজের ডিরেক্টরি তৈরি করুন:
```
mkdir quickstart
```
কাজের ডিরেক্টরিতে পরিবর্তন করুন:
```
cd quickstart
```
নতুন মডিউল শুরু করুন:
```
go mod init quickstart
```
অ্যাডমিন SDK API Go ক্লায়েন্ট লাইব্রেরি এবং OAuth2.0 প্যাকেজ পান:
```
go get google.golang.org/api/admin/reports/v1
go get golang.org/x/oauth2/google
```

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

আপনার কাজের ডিরেক্টরিতে, quickstart.go নামে একটি ফাইল তৈরি করুন।

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

admin_sdk/reports/quickstart.go

GitHub এ দেখুন

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)
		}
	}
}

নমুনা চালান

আপনার কাজের ডিরেক্টরিতে, নমুনা তৈরি করুন এবং চালান:
```
go run quickstart.go
```

আপনি যখন প্রথমবার নমুনা চালান, এটি আপনাকে অ্যাক্সেস অনুমোদন করতে অনুরোধ করে:
1. আপনি যদি ইতিমধ্যে আপনার Google অ্যাকাউন্টে সাইন ইন না করে থাকেন, প্রম্পট করা হলে সাইন ইন করুন৷ আপনি একাধিক অ্যাকাউন্টে সাইন ইন করে থাকলে, অনুমোদনের জন্য ব্যবহার করার জন্য একটি অ্যাকাউন্ট নির্বাচন করুন।
2. স্বীকার করুন ক্লিক করুন.
আপনার Go অ্যাপ্লিকেশনটি চালায় এবং অ্যাডমিন SDK API-কে কল করে।
অনুমোদনের তথ্য ফাইল সিস্টেমে সংরক্ষণ করা হয়, তাই পরের বার যখন আপনি নমুনা কোডটি চালাবেন, তখন আপনাকে অনুমোদনের জন্য অনুরোধ করা হবে না।