সেট আপ করুন এবং OAuth ব্যবহার করুন

সমস্ত স্থানীয় পরিষেবা API কল অবশ্যই OAuth 2.0 এর মাধ্যমে অনুমোদিত হতে হবে৷ এটি আপনার Local Services API ক্লায়েন্ট অ্যাপকে ব্যবহারকারীর Local Services Ads অ্যাকাউন্ট অ্যাক্সেস করতে দেয় ব্যবহারকারীর লগইন তথ্য পরিচালনা বা সঞ্চয় করার প্রয়োজন ছাড়াই।

স্থানীয় পরিষেবা API ব্যবহারকারীদের প্রমাণীকরণ করতে OAuth 2.0 প্রোটোকল ব্যবহার করে। OAuth 2.0 সম্পর্কে আরও জানতে, Google API অ্যাক্সেস করতে OAuth 2.0 ব্যবহার করা দেখুন।

স্থানীয় পরিষেবা API-এর জন্য একটি Google API কনসোল প্রকল্প কনফিগার করুন৷

Google বিজ্ঞাপন ব্যবহারকারীদের প্রমাণীকরণ এবং অনুমোদন করতে, আপনার কাছে Google-এর OAuth 2.0 সার্ভার অ্যাক্সেস করার জন্য শংসাপত্র থাকতে হবে। এই শংসাপত্রগুলি Google-এ আপনার আবেদন শনাক্ত করে এবং Google বিজ্ঞাপন ব্যবহারকারীদের পরিচালনা করার জন্য আপনাকে OAuth টোকেন তৈরি করতে দেয়। আপনার Google OAuth 2.0 শংসাপত্রগুলিতে অ্যাক্সেস পরিচালনা করতে Google API কনসোল ব্যবহার করুন৷

এই শংসাপত্রগুলি পেতে, নিম্নলিখিত পদক্ষেপগুলি সম্পাদন করুন:

1. একটি প্রকল্প তৈরি করুন। এটি করতে, Google API কনসোলে নেভিগেট করুন। প্রকল্প তৈরি করুন ক্লিক করুন, একটি নাম লিখুন এবং তৈরি করুন ক্লিক করুন।

2. আপনার প্রকল্পে স্থানীয় পরিষেবা API সক্ষম করুন:

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

      যদি Local Services API তালিকায় দৃশ্যমান না হয়, তাহলে এটি খুঁজতে সার্চ বক্স ব্যবহার করুন।

   2. Local Services API নির্বাচন করুন, তারপর Enable এ ক্লিক করুন।

3. একটি অ্যাপের ধরন বেছে নিন। Local Services API Google Ads API-এর মতো একই ধরনের অ্যাপ ব্যবহার করে। কোন অ্যাপ টাইপ ব্যবহার করতে হবে তার আরও বিস্তারিত জানার জন্য, একটি অ্যাপের ধরন বেছে নিন দেখুন।

4. একটি ক্লায়েন্ট আইডি এবং ক্লায়েন্ট সিক্রেট তৈরি করুন। Local Services API-এর জন্য, Google Ads API-এর জন্য ব্যবহৃত ক্লায়েন্ট আইডি এবং ক্লায়েন্ট সিক্রেট তৈরি করতে একই ধাপ অনুসরণ করুন। উভয় ব্যবহারের ক্ষেত্রে পদক্ষেপগুলি অভিন্ন।

OAuth 2.0 টোকেন পেতে ক্লায়েন্ট লাইব্রেরি ব্যবহার করুন

ক্লায়েন্ট লাইব্রেরির একটি তালিকার জন্য আপনি OAuth 2.0 অনুমোদনের অনুরোধ করতে ব্যবহার করতে পারেন, ক্লায়েন্ট লাইব্রেরি দেখুন। একটি নতুন অ্যাক্সেস টোকেন পেতে রিফ্রেশ টোকেন কীভাবে ব্যবহার করবেন তা শিখতে লাইব্রেরি-নির্দিষ্ট নির্দেশাবলী অনুসরণ করুন।

কিভাবে একটি OAuth 2.0 রিফ্রেশ টোকেন পাবেন

আমরা সুপারিশ করি যে আপনি ব্যবহারকারীদের প্রমাণীকরণের জন্য উৎপাদনে ক্লায়েন্ট লাইব্রেরি ব্যবহার করুন। আপনি যদি পরীক্ষার উদ্দেশ্যে একটি HTTP ক্লায়েন্ট ব্যবহার করতে চান, তাহলে একটি OAuth 2.0 রিফ্রেশ টোকেন এবং একটি অ্যাক্সেস টোকেন পেতে নিম্নলিখিত নির্দেশাবলী ব্যবহার করুন৷ ধাপ 1, 2, এবং 3 হল এক-সময়ের সেটআপ নির্দেশাবলী যা আপনাকে অবশ্যই ম্যানুয়ালি সম্পাদন করতে হবে, এবং পদক্ষেপ 4 এবং 5 পরে স্বয়ংক্রিয়ভাবে মানুষের হস্তক্ষেপ ছাড়াই চালানো যেতে পারে, যেমন একটি ক্রোন জব।

1. এইচটিটিপি ওয়েব অনুরোধ করার জন্য একটি কমান্ড লাইন টুল, কার্ল ডাউনলোড এবং ইনস্টল করুন ।

2. একটি OAuth 2.0 রিফ্রেশ টোকেন পেতে OAuth প্লেগ্রাউন্ড পৃষ্ঠার নির্দেশাবলী অনুসরণ করুন। স্থানীয় পরিষেবা API-এর জন্য নিম্নলিখিত সুযোগ ব্যবহার করুন:

   https://www.googleapis.com/auth/adwords
   

   এটি একই OAuth 2.0 স্কোপ Google Ads API ব্যবহার করে।

   এই ধাপের শেষে, আপনি দুটি টোকেন পাবেন: একটি রিফ্রেশ টোকেন এবং একটি অ্যাক্সেস টোকেন। তাদের দুজনকেই বাঁচান।

3. পূর্ববর্তী পদক্ষেপটি সফল হয়েছে তা যাচাই করতে একটি কমান্ড প্রম্পটে নিম্নলিখিত কমান্ডটি চালান:

   curl https://oauth2.googleapis.com/tokeninfo?access_token=<INSERT_ACCESS_TOKEN>
   

   যদি কমান্ড আউটপুট নিম্নলিখিত মত একটি বার্তা প্রদর্শন করে, এটি সফল ছিল:

   {
     "azp": "************-********************************.apps.googleusercontent.com",
     "aud": "************-********************************.apps.googleusercontent.com",
     "scope": "https://www.googleapis.com/auth/adwords [googleapis.com]",
     "exp": "1611183382",
     "expires_in": "3482",
     "access_type": "offline"
   }
   

   যদি কোনো ত্রুটি থাকে বা সুযোগ সঠিক না হয়, আবার টোকেন তৈরি করার চেষ্টা করুন।

4. ম্যানুয়াল হস্তক্ষেপ ছাড়াই একটি নতুন অ্যাক্সেস টোকেন তৈরি করুন। এটি গুরুত্বপূর্ণ কারণ অ্যাক্সেস টোকেন প্রতি ঘণ্টায় মেয়াদ শেষ হয়। রিফ্রেশ টোকেনগুলির মেয়াদ শেষ হতে অনেক বেশি সময় লাগে, তাই আপনাকে প্রায়শই সেগুলিকে ম্যানুয়ালি প্রত্যাহার করতে হবে যখন সেগুলির আর প্রয়োজন নেই৷

   একটি নতুন অ্যাক্সেস টোকেন পেতে, নিম্নলিখিত কমান্ডটি চালান:

   curl --data "refresh_token=<INSERT_REFRESH_TOKEN>&client_id=<INSERT_CLIENT_ID>&client_secret=<INSERT_CLIENT_SECRET>&grant_type=refresh_token" -X POST "https://oauth2.googleapis.com/token”
   

5. নিম্নলিখিত API কল চালান:

   curl -H "Authorization: Bearer <INSERT_ACCESS_TOKEN>" https://localservices.googleapis.com/v1/accountReports:search?query=manager_customer_id:<INSERT_10_DIGIT_MANAGER_CUSTOMER_ID_WITHOUT_HYPHENS>
   

   এই কল সফল হলে, আপনার সেটআপ সম্পূর্ণ।