আপনি সরাসরি বা SDK এর মাধ্যমে এই API ব্যবহার করার আগে আপনাকে অবশ্যই Google ক্লাউড অনুসন্ধান API-এ অ্যাক্সেস কনফিগার করতে হবে। এই দস্তাবেজটি Google ক্লাউড অনুসন্ধান API REST API ব্যবহার করার জন্য প্রয়োজনীয় পদক্ষেপগুলি কভার করে৷
1. একটি API প্রকল্প তৈরি করুন
API সক্ষম করতে, আপনাকে প্রথমে একটি Google ক্লাউড প্রকল্প তৈরি করতে হবে। এই প্রকল্পটি API গুলি পরিচালনা, বিলিং সক্ষম করা, সহযোগীদের যোগ করা এবং সরানো এবং অনুমতিগুলি পরিচালনা সহ সমস্ত Google ক্লাউড পরিষেবা তৈরি, সক্ষম এবং ব্যবহার করার ভিত্তি তৈরি করে৷
গুগল ক্লাউড কনসোল খুলুন।
পৃষ্ঠার শীর্ষে, "Google ক্লাউড কনসোল" এর ডানদিকে
এ ক্লিক করুন৷ বর্তমান প্রকল্প তালিকাভুক্ত একটি ডায়ালগ প্রদর্শিত হবে.নতুন প্রকল্পে ক্লিক করুন। "নতুন প্রকল্প" স্ক্রীন প্রদর্শিত হবে।
প্রকল্পের নাম ক্ষেত্রে একটি প্রকল্পের নাম লিখুন।
(ঐচ্ছিক) প্রকল্প আইডি সম্পাদনা করতে সম্পাদনা ক্লিক করুন। প্রোজেক্ট তৈরি হওয়ার পর প্রোজেক্ট আইডি পরিবর্তন করা যাবে না, তাই এমন একটি আইডি বেছে নিন যা প্রোজেক্টের জীবনকালের জন্য আপনার চাহিদা পূরণ করে।
প্রকল্পের জন্য অবস্থানগুলি ব্রাউজ করতে, BROWSE এ ক্লিক করুন।
আপনার প্রকল্পের জন্য একটি অবস্থানে ক্লিক করুন এবং নির্বাচন করুন ক্লিক করুন।
তৈরি করুন ক্লিক করুন। কনসোলটি ড্যাশবোর্ড পৃষ্ঠায় নেভিগেট করে। প্রকল্পটি কয়েক মিনিটের মধ্যে তৈরি হয়।
প্রকল্প তৈরি এবং পরিচালনার বিষয়ে আরও তথ্যের জন্য, প্রজেক্ট তৈরি এবং পরিচালনা করুন দেখুন।
2. API সক্রিয় করুন
আপনাকে Google ক্লাউড অনুসন্ধান API সক্ষম করতে হবে এবং শংসাপত্রগুলি পেতে একটি পরিষেবা অ্যাকাউন্ট তৈরি করতে হবে৷
- আপনি নতুন তৈরি প্রকল্পে আছেন তা নিশ্চিত করতে, Google ক্লাউড কনসোল ব্যানারের ডানদিকে আইকনে ক্লিক করুন এবং আপনার নতুন তৈরি করা প্রকল্প নির্বাচন করুন৷
- APIs এবং পরিষেবাগুলি সক্ষম করুন ক্লিক করুন৷ "এপিআই লাইব্রেরিতে স্বাগতম" পৃষ্ঠাটি প্রদর্শিত হবে।
- Google ক্লাউড অনুসন্ধান API- এ নেভিগেট করুন।
- সক্ষম করুন ক্লিক করুন। "ওভারভিউ" পৃষ্ঠাটি প্রদর্শিত হবে।
API গুলি সক্রিয় এবং নিষ্ক্রিয় করার বিষয়ে আরও তথ্যের জন্য, Google ক্লাউড কনসোলে APIগুলি পরিচালনা করুন দেখুন৷
3. পরিষেবা অ্যাকাউন্টের শংসাপত্র তৈরি করুন
- Google ক্লাউড কনসোলে , বাম নেভিগেশনে শংসাপত্রে ক্লিক করুন। শংসাপত্র পৃষ্ঠা প্রদর্শিত হবে.
- শংসাপত্র তৈরি করুন ড্রপ-ডাউন তালিকা থেকে, পরিষেবা অ্যাকাউন্ট নির্বাচন করুন। "পরিষেবা অ্যাকাউন্ট তৈরি করুন" পৃষ্ঠাটি প্রদর্শিত হবে।
- পরিষেবা অ্যাকাউন্ট নামের ক্ষেত্রে একটি নাম লিখুন।
- (ঐচ্ছিক) পরিষেবা অ্যাকাউন্ট আইডি সম্পাদনা করুন।
- তৈরি করুন ক্লিক করুন। একটি "পরিষেবা অ্যাকাউন্ট অনুমতি" স্ক্রীন প্রদর্শিত হবে।
- অবিরত ক্লিক করুন. একটি "এই পরিষেবা অ্যাকাউন্টে ব্যবহারকারীদের অ্যাক্সেস দিন" স্ক্রীন প্রদর্শিত হবে৷
- কী তৈরি করুন ক্লিক করুন এবং সম্পন্ন ক্লিক করুন। একটি "ব্যক্তিগত কী আপনার কম্পিউটারে সংরক্ষিত" ডায়ালগ প্রদর্শিত হবে এবং আপনার কম্পিউটারে ব্যক্তিগত কী ডাউনলোডের একটি অনুলিপি।
- বন্ধ ক্লিক করুন.
পরিষেবা অ্যাকাউন্টগুলির আরও তথ্যের জন্য, পরিষেবা অ্যাকাউন্ট, ওয়েব অ্যাপ্লিকেশন এবং ইনস্টল করা অ্যাপ্লিকেশনগুলি পড়ুন৷
4. ইমেল ঠিকানা সনাক্ত করুন
- Google ক্লাউড কনসোল থেকে, পৃষ্ঠার শীর্ষে আপনার তৈরি করা প্রকল্পটি নির্বাচন করুন৷
- Google ক্লাউড কনসোল ব্যানারের বাম দিকে নেভিগেশন মেনুতে ক্লিক করুন।
- IAM এবং Admin > Service accounts এ ক্লিক করুন।
- তালিকায়, "পরিষেবা অ্যাকাউন্ট আইডি"-এর অধীনে তৈরি করা ইমেল ঠিকানাটি নোট করুন যা আপনার কনফিগার করা পরিষেবা অ্যাকাউন্টটিকে শনাক্ত করে৷ ক্লাউড অনুসন্ধানে একটি ডেটা উত্স যোগ করার সময় এই ইমেল ঠিকানাটি ব্যবহার করা হয়৷
5. তৃতীয়-পক্ষ সমর্থন শুরু করুন
আপনি অন্য কোনো ক্লাউড অনুসন্ধান API কল করার আগে, আপনাকে অবশ্যই Google ক্লাউড অনুসন্ধানের জন্য তৃতীয় পক্ষের সমর্থন শুরু করতে হবে।
ক্লাউড অনুসন্ধানের জন্য তৃতীয়-পক্ষ সমর্থন শুরু করতে:
আপনার ক্লাউড অনুসন্ধান প্ল্যাটফর্ম প্রকল্পে পরিষেবা অ্যাকাউন্টের শংসাপত্র রয়েছে৷ যাইহোক, তৃতীয় পক্ষের সমর্থন শুরু করার জন্য, আপনাকে অবশ্যই ওয়েব অ্যাপ্লিকেশন শংসাপত্র তৈরি করতে হবে। কিভাবে ওয়েব অ্যাপ্লিকেশন শংসাপত্র তৈরি করতে হয় তার নির্দেশাবলীর জন্য, শংসাপত্র তৈরি করুন দেখুন। এই ধাপটি সম্পূর্ণ করার পরে, আপনার একটি ক্লায়েন্ট আইডি এবং ক্লায়েন্ট গোপন ফাইল থাকা উচিত।
একটি অ্যাক্সেস টোকেন পেতে Google এর OAuth 2 খেলার মাঠ ব্যবহার করুন:
- সেটিংসে ক্লিক করুন এবং ব্যবহারকারীর আপনার নিজস্ব প্রমাণীকরণ শংসাপত্র পরীক্ষা করুন।
- ধাপ 1 থেকে ক্লায়েন্ট আইডি এবং ক্লায়েন্ট সিক্রেট লিখুন।
- বন্ধ ক্লিক করুন.
- স্কোপ ফিল্ডে,
https://www.googleapis.com/auth/cloud_search.settings
টাইপ করুন এবং অনুমোদন এ ক্লিক করুন। OAuth 2 খেলার মাঠ একটি অনুমোদন কোড প্রদান করে। - টোকেনের জন্য এক্সচেঞ্জ অনুমোদন কোড ক্লিক করুন। একটি টোকেন ফেরত দেওয়া হয়।
ক্লাউড অনুসন্ধানের জন্য তৃতীয়-পক্ষ সমর্থন শুরু করতে, নিম্নলিখিত কার্ল কমান্ডটি ব্যবহার করুন। ধাপ 2 এ প্রাপ্ত টোকেন দিয়ে
[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
যখন তৃতীয় পক্ষের সূচনা সম্পূর্ণ হয়, এতে
true
সেটdone
ক্ষেত্রটি থাকে। যেমন:{ name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY" done: true }
পরবর্তী পদক্ষেপ
এখানে কয়েকটি পরবর্তী পদক্ষেপ যা আপনি নিতে পারেন:
আপনি যদি Microsoft® SharePoint® এর মতো একটি নন-Google ডেটা রিপোজিটরির সাথে Google ক্লাউড অনুসন্ধান ব্যবহার করার পরিকল্পনা করেন, তাহলে আপনাকে অবশ্যই একটি ডেটা উৎস তৈরি করতে হবে। একটি ডেটা উত্স যোগ করার নির্দেশাবলীর জন্য, অনুসন্ধানের জন্য একটি ডেটা উত্স যোগ করুন দেখুন৷
একবার আপনি আপনার ডেটা উত্স সেট আপ করার পরে, আপনি Google ক্লাউড অনুসন্ধান কীভাবে সংগ্রহস্থলে ডেটা উপস্থাপন করবে তা সনাক্ত করতে স্কিমা তৈরি এবং নিবন্ধন করতে পারেন৷