সরাসরি বা এসডিকে-এর মাধ্যমে গুগল ক্লাউড সার্চ এপিআই ব্যবহার করার আগে আপনাকে অবশ্যই এর অ্যাক্সেস কনফিগার করতে হবে। এই ডকুমেন্টটিতে ক্লাউড সার্চ এপিআই রেস্ট এপিআই-এর জন্য প্রয়োজনীয় ধাপগুলো আলোচনা করা হয়েছে।
১. একটি এপিআই প্রজেক্ট তৈরি করুন
এপিআই সক্রিয় করতে, প্রথমে একটি গুগল ক্লাউড প্রজেক্ট তৈরি করুন। এই প্রজেক্টটি গুগল ক্লাউড পরিষেবা ব্যবহার, এপিআই পরিচালনা এবং অনুমতি নির্ধারণের ভিত্তি।
- গুগল ক্লাউড কনসোলটি খুলুন।
- ‘Google Cloud console’-এর ডানদিকে থাকা প্রজেক্ট ড্রপ-ডাউনে ক্লিক করুন এবং NEW PROJECT নির্বাচন করুন।
- প্রজেক্টের নাম ফিল্ডে একটি নাম লিখুন।
- (ঐচ্ছিক) প্রজেক্ট আইডি পরিবর্তন করতে এডিট-এ ক্লিক করুন। একবার তৈরি করার পর এই আইডি পরিবর্তন করা যাবে না।
- অবস্থান বেছে নিতে BROWSE-এ ক্লিক করুন, তারপর Select-এ ক্লিক করুন।
- Create-এ ক্লিক করুন। প্রজেক্টটি সাধারণত কয়েক মিনিটের মধ্যেই প্রস্তুত হয়ে যায়।
আরও তথ্যের জন্য, প্রকল্প তৈরি ও পরিচালনা দেখুন।
২. এপিআই সক্রিয় করুন
ক্রেডেনশিয়াল পেতে ক্লাউড সার্চ এপিআই সক্রিয় করুন এবং একটি পরিষেবা অ্যাকাউন্ট তৈরি করুন।
- গুগল ক্লাউড কনসোল ব্যানারের ড্রপ-ডাউন মেনু থেকে আপনার নতুন প্রজেক্টটি নির্বাচন করুন।
- এপিআই এবং পরিষেবাগুলো সক্ষম করুন-এ ক্লিক করুন।
- Google Cloud Search API অনুসন্ধান করুন এবং নির্বাচন করুন।
- সক্ষম করুন -এ ক্লিক করুন।
আরও তথ্যের জন্য, Google Cloud কনসোলে API পরিচালনা (Manage APIs) দেখুন।
৩. পরিষেবা অ্যাকাউন্টের পরিচয়পত্র তৈরি করুন
- গুগল ক্লাউড কনসোলে , বাম দিকের নেভিগেশনে থাকা ক্রেডেনশিয়ালস (Credentials) -এ ক্লিক করুন।
- Create credentials ড্রপ-ডাউন মেনু থেকে সার্ভিস অ্যাকাউন্ট নির্বাচন করুন।
- সার্ভিস অ্যাকাউন্ট নেম ফিল্ডে একটি নাম লিখুন।
- (ঐচ্ছিক) পরিষেবা অ্যাকাউন্ট আইডি সম্পাদনা করুন।
- তৈরি করুন-এ ক্লিক করুন এবং চালিয়ে যান ।
- "সার্ভিস অ্যাকাউন্টস" তালিকায় পৌঁছানোর জন্য "সম্পন্ন " ক্লিক করুন।
- আপনার নতুন পরিষেবা অ্যাকাউন্টের ইমেলে ক্লিক করুন, তারপর ' Keys' ট্যাবটি নির্বাচন করুন।
- অ্যাড কী (ADD KEY) > নতুন কী (Create new key) -তে ক্লিক করুন।
- JSON নির্বাচন করুন এবং Create-এ ক্লিক করুন। প্রাইভেট কী-টি আপনার কম্পিউটারে ডাউনলোড হয়ে যাবে।
আরও তথ্যের জন্য, পরিষেবা অ্যাকাউন্টগুলি দেখুন।
৪. পরিষেবা অ্যাকাউন্টের ইমেল শনাক্ত করুন
- গুগল ক্লাউড কনসোলে আপনার প্রজেক্টটি নির্বাচন করুন।
- নেভিগেশন মেনু > আইএএম ও অ্যাডমিন > সার্ভিস অ্যাকাউন্টস-এ ক্লিক করুন।
- আপনার পরিষেবা অ্যাকাউন্টের ইমেল ঠিকানাটি লিখে রাখুন। ক্লাউড সার্চে ডেটা সোর্স যোগ করার জন্য এটি প্রয়োজন হবে।
৫. তৃতীয় পক্ষের সমর্থন চালু করুন
অন্য কোনো ক্লাউড সার্চ এপিআই কল করার আগে গুগল ক্লাউড সার্চের জন্য থার্ড-পার্টি সাপোর্ট চালু করুন।
তৃতীয় পক্ষের সমর্থন চালু করতে:
- আপনার ক্লাউড সার্চ প্ল্যাটফর্ম প্রজেক্টে ওয়েব অ্যাপ্লিকেশন ক্রেডেনশিয়াল তৈরি করুন। ক্রেডেনশিয়াল তৈরি করুন দেখুন। আপনার ক্লায়েন্ট আইডি এবং ক্লায়েন্ট সিক্রেট প্রয়োজন হবে।
- OAuth 2.0 প্লেগ্রাউন্ড ব্যবহার করে একটি অ্যাক্সেস টোকেন সংগ্রহ করুন:
- OAuth 2.0 কনফিগারেশন (সেটিংস আইকন)-এ ক্লিক করুন এবং 'Use your own OAuth credentials' বিকল্পটি চেক করুন।
- আপনার ক্লায়েন্ট আইডি এবং ক্লায়েন্ট সিক্রেট প্রবেশ করান।
- স্কোপস ফিল্ডে
https://www.googleapis.com/auth/cloud_search.settingsলিখুন এবং অথরাইজ এপিআই (Authorize APIs) এ ক্লিক করুন। - টোকেনগুলির জন্য বিনিময় অনুমোদন কোডে ক্লিক করুন।
এই কার্ল কমান্ডটি চালান, এবং
[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অন্তর্ভুক্ত থাকে। এটি ব্যর্থ হলে, ক্লাউড সার্চ সাপোর্টের সাথে যোগাযোগ করুন।প্রারম্ভিকতা যাচাই করতে
operations.getব্যবহার করুন:curl 'https://cloudsearch.googleapis.com/v1/operations/<var>operation_name</var>?key=[YOUR_API_KEY]' \ --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \ --header 'Accept: application/json' \ --compressedপ্রারম্ভিকীকরণ সম্পূর্ণ হয় যখন
donetrueহয়।
পরবর্তী পদক্ষেপ
- Microsoft® SharePoint®-এর মতো Google-বহির্ভূত কোনো রিপোজিটরির সাথে ক্লাউড সার্চ ব্যবহার করতে হলে, আপনাকে একটি ডেটা সোর্স তৈরি করতে হবে। সার্চ করার জন্য একটি ডেটা সোর্স যোগ করুন দেখুন।
- আপনার ডেটা সোর্স সেট আপ করার পরে, একটি স্কিমা তৈরি এবং রেজিস্টার করুন , যা নির্ধারণ করবে ক্লাউড সার্চ আপনার ডেটা কীভাবে উপস্থাপন করবে।