এই API সরাসরি অথবা SDK এর মাধ্যমে ব্যবহার করার আগে আপনাকে Google Cloud Search API-এর অ্যাক্সেস কনফিগার করতে হবে। এই ডকুমেন্টে Google Cloud Search API REST API ব্যবহার করার জন্য প্রয়োজনীয় পদক্ষেপগুলি অন্তর্ভুক্ত করা হয়েছে।
১. একটি API প্রকল্প তৈরি করুন
API সক্ষম করতে, আপনাকে প্রথমে একটি Google ক্লাউড প্রকল্প তৈরি করতে হবে। এই প্রকল্পটি API পরিচালনা, বিলিং সক্ষম করা, সহযোগীদের যোগ করা এবং অপসারণ করা এবং অনুমতি পরিচালনা সহ সমস্ত Google ক্লাউড পরিষেবা তৈরি, সক্ষম করা এবং ব্যবহারের ভিত্তি তৈরি করে।
গুগল ক্লাউড কনসোলটি খুলুন।
পৃষ্ঠার উপরের দিকে, "গুগল ক্লাউড কনসোল" এর ডানদিকে এ ক্লিক করুন। বর্তমান প্রকল্পগুলির তালিকা সহ একটি ডায়ালগ প্রদর্শিত হবে।
NEW PROJECT এ ক্লিক করুন। "New Project" স্ক্রিনটি প্রদর্শিত হবে।
প্রকল্পের নাম ক্ষেত্রে একটি প্রকল্পের নাম লিখুন।
(ঐচ্ছিক) প্রজেক্ট আইডি সম্পাদনা করতে সম্পাদনা ক্লিক করুন। প্রজেক্ট তৈরির পরে প্রজেক্ট আইডি পরিবর্তন করা যাবে না, তাই এমন একটি আইডি বেছে নিন যা প্রজেক্টের জীবদ্দশায় আপনার চাহিদা পূরণ করে।
প্রকল্পের জন্য অবস্থানগুলি ব্রাউজ করতে, ব্রাউজ করুন এ ক্লিক করুন।
আপনার প্রকল্পের জন্য একটি অবস্থানে ক্লিক করুন এবং নির্বাচন করুন ক্লিক করুন।
তৈরি করুন এ ক্লিক করুন। কনসোলটি ড্যাশবোর্ড পৃষ্ঠায় নেভিগেট করে। কয়েক মিনিটের মধ্যেই প্রকল্পটি তৈরি হয়ে যায়।
প্রকল্প তৈরি এবং পরিচালনা সম্পর্কে আরও তথ্যের জন্য, প্রকল্প তৈরি এবং পরিচালনা দেখুন।
2. API সক্রিয় করুন
শংসাপত্র পেতে আপনাকে Google Cloud Search API সক্ষম করতে হবে এবং একটি পরিষেবা অ্যাকাউন্ট তৈরি করতে হবে।
- আপনি নতুন তৈরি প্রকল্পে আছেন কিনা তা নিশ্চিত করতে, Google Cloud console ব্যানারের ডানদিকে আইকনে ক্লিক করুন এবং আপনার নতুন তৈরি প্রকল্পটি নির্বাচন করুন।
- ENABLE APIS AND SERVICES এ ক্লিক করুন। "Welcome to API Library" পৃষ্ঠাটি প্রদর্শিত হবে।
- গুগল ক্লাউড সার্চ এপিআই- তে নেভিগেট করুন।
- Enable এ ক্লিক করুন। "Overview" পৃষ্ঠাটি প্রদর্শিত হবে।
API গুলি সক্ষম এবং নিষ্ক্রিয় করার বিষয়ে আরও তথ্যের জন্য, Google ক্লাউড কনসোলে API গুলি পরিচালনা করুন দেখুন।
৩. পরিষেবা অ্যাকাউন্টের শংসাপত্র তৈরি করুন
- গুগল ক্লাউড কনসোলে , বাম দিকের নেভিগেশনে Credentials- এ ক্লিক করুন। Credential পৃষ্ঠাটি প্রদর্শিত হবে।
- ক্রিয়েট ক্রেডেনশিয়াল ড্রপ-ডাউন তালিকা থেকে, সার্ভিস অ্যাকাউন্ট নির্বাচন করুন। "করিয়েট সার্ভিস অ্যাকাউন্ট" পৃষ্ঠাটি প্রদর্শিত হবে।
- পরিষেবা অ্যাকাউন্টের নাম ক্ষেত্রে একটি নাম লিখুন।
- (ঐচ্ছিক) পরিষেবা অ্যাকাউন্ট আইডি সম্পাদনা করুন।
- তৈরি করুন এ ক্লিক করুন। "পরিষেবা অ্যাকাউন্টের অনুমতি" স্ক্রিনটি প্রদর্শিত হবে।
- " চালু থাকুন " এ ক্লিক করুন। "ব্যবহারকারীদের এই পরিষেবা অ্যাকাউন্টে অ্যাক্সেস প্রদান করুন" স্ক্রিনটি প্রদর্শিত হবে।
- CREATE KEY এ ক্লিক করুন এবং Done এ ক্লিক করুন। "Private key saved to your computer" ডায়ালগটি প্রদর্শিত হবে এবং আপনার কম্পিউটারে private key এর একটি কপি ডাউনলোড হবে।
- বন্ধ করুন ক্লিক করুন।
পরিষেবা অ্যাকাউন্ট সম্পর্কে আরও তথ্যের জন্য, পরিষেবা অ্যাকাউন্ট, ওয়েব অ্যাপ্লিকেশন এবং ইনস্টল করা অ্যাপ্লিকেশনগুলি দেখুন।
৪. ইমেল ঠিকানা সনাক্ত করুন
- গুগল ক্লাউড কনসোল থেকে, পৃষ্ঠার শীর্ষে আপনার তৈরি করা প্রকল্পটি নির্বাচন করুন।
- গুগল ক্লাউড কনসোল ব্যানারের বাম দিকের নেভিগেশন মেনুতে ক্লিক করুন।
- IAM এবং অ্যাডমিন > পরিষেবা অ্যাকাউন্ট ক্লিক করুন।
- "পরিষেবা অ্যাকাউন্ট আইডি" তালিকায়, আপনার কনফিগার করা পরিষেবা অ্যাকাউন্টটি শনাক্তকারী জেনারেট করা ইমেল ঠিকানাটি নোট করুন। ক্লাউড অনুসন্ধানে ডেটা উৎস যোগ করার সময় এই ইমেল ঠিকানাটি ব্যবহার করা হয়।
৫. তৃতীয় পক্ষের সহায়তা শুরু করুন
অন্য কোনও ক্লাউড সার্চ এপিআই কল করার আগে, আপনাকে গুগল ক্লাউড সার্চের জন্য তৃতীয় পক্ষের সহায়তা শুরু করতে হবে।
ক্লাউড সার্চের জন্য তৃতীয় পক্ষের সহায়তা শুরু করতে:
আপনার ক্লাউড সার্চ প্ল্যাটফর্ম প্রজেক্টে পরিষেবা অ্যাকাউন্টের শংসাপত্র রয়েছে। তবে, তৃতীয় পক্ষের সহায়তা শুরু করার জন্য, আপনাকে অবশ্যই ওয়েব অ্যাপ্লিকেশন শংসাপত্র তৈরি করতে হবে। ওয়েব অ্যাপ্লিকেশন শংসাপত্র কীভাবে তৈরি করবেন তার নির্দেশাবলীর জন্য, ক্রিয়েট ক্রিয়েশনাল দেখুন। এই ধাপটি সম্পন্ন করার পরে, আপনার একটি ক্লায়েন্ট আইডি এবং ক্লায়েন্ট গোপন ফাইল থাকা উচিত।
অ্যাক্সেস টোকেন পেতে Google এর OAuth 2 খেলার মাঠ ব্যবহার করুন:
- সেটিংসে ক্লিক করুন এবং আপনার নিজস্ব প্রমাণীকরণ শংসাপত্র ব্যবহার করুন।
- ধাপ ১ থেকে ক্লায়েন্ট আইডি এবং ক্লায়েন্ট সিক্রেট লিখুন।
- বন্ধ করুন ক্লিক করুন।
- স্কোপ ফিল্ডে,
https://www.googleapis.com/auth/cloud_search.settingsটাইপ করুন এবং Authorize এ ক্লিক করুন। OAuth 2 খেলার মাঠ একটি অনুমোদন কোড প্রদান করে। - টোকেনের জন্য এক্সচেঞ্জ অনুমোদন কোডে ক্লিক করুন। একটি টোকেন ফেরত পাঠানো হয়।
ক্লাউড সার্চের জন্য তৃতীয় পক্ষের সহায়তা শুরু করতে, নিম্নলিখিত curl কমান্ডটি ব্যবহার করুন। ধাপ ২-এ প্রাপ্ত টোকেনটি দিয়ে
[YOUR_ACCESS_TOKEN]প্রতিস্থাপন করতে ভুলবেন না।curl --request POST \ 'https://cloudsearch.googleapis.com/v1:initializeCustomer' \ --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{}' \ --compressedযদি সফল হয়, তাহলে রেসপন্স বডিতে
operationএকটি উদাহরণ থাকবে। উদাহরণস্বরূপ:{ name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY" }যদি ব্যর্থ হন, তাহলে ক্লাউড সার্চ সাপোর্টের সাথে যোগাযোগ করুন।
তৃতীয় পক্ষের সহায়তা শুরু হয়েছে কিনা তা যাচাই করতে operations.get ব্যবহার করুন:
curl \ 'https://cloudsearch.googleapis.com/v1/operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY?key= [YOUR_API_KEY]' \ --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \ --header 'Accept: application/json' \ --compressedযখন তৃতীয় পক্ষের ইনিশিয়ালাইজেশন সম্পূর্ণ হয়, তখন এতে
done" ক্ষেত্রটিtrueতে সেট করা থাকে। উদাহরণস্বরূপ:{ name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY" done: true }
পরবর্তী পদক্ষেপ
আপনার পরবর্তী কিছু পদক্ষেপ এখানে দেওয়া হল:
যদি আপনি Google ক্লাউড সার্চ ব্যবহার করার পরিকল্পনা করেন, তাহলে Microsoft® SharePoint® এর মতো অন্য কোনও ডেটা রিপোজিটরির সাথে, আপনাকে অবশ্যই একটি ডেটা সোর্স তৈরি করতে হবে। ডেটা সোর্স যোগ করার নির্দেশাবলীর জন্য, অনুসন্ধানে একটি ডেটা সোর্স যোগ করুন দেখুন।
একবার আপনি আপনার ডেটা সোর্স সেট আপ করার পরে, আপনি স্কিমা তৈরি এবং নিবন্ধন করতে পারেন যা Google Cloud Search কীভাবে রিপোজিটরিতে ডেটা উপস্থাপন করবে তা সনাক্ত করতে পারে।