OAuth ডেস্কটপ এবং ওয়েব অ্যাপ্লিকেশন প্রবাহ

এই নির্দেশিকাটি আপনাকে আপনার নিজস্ব শংসাপত্র এবং ডেস্কটপ ফ্লো অথবা ওয়েব ফ্লো ব্যবহার করে API অ্যাক্সেসের জন্য OAuth 2.0 কীভাবে সেট আপ করবেন তা ব্যাখ্যা করবে। এই পদক্ষেপগুলি কেবল একবারই করতে হবে, যদি না আপনি আপনার OAuth 2.0 শংসাপত্রের জন্য অনুমোদিত স্কোপগুলি প্রত্যাহার, মুছে ফেলতে বা পরিবর্তন করতে চান।

OAuth 2.0 শংসাপত্র তৈরি করুন

  1. Google Ads API এর জন্য একটি Google API কনসোল প্রকল্প কনফিগার করতে ধাপগুলি অনুসরণ করুন।

  2. ক্লায়েন্টের JSON ফাইলটি ডাউনলোড করতে প্রথমে তার ডাউনলোড OAuth ক্লায়েন্ট আইকনে ক্লিক করুন এবং তারপর পরবর্তী স্ক্রিনে DOWNLOAD JSON বোতামে ক্লিক করুন।

    ফাইলটি আপনার হোম ডিরেক্টরিতে সংরক্ষণ করুন যাতে আপনার কাছে এখন স্থানীয় ফাইল ~/client_secret_XXX.apps.googleusercontent.com.json থাকে (যেখানে XXX আপনার প্রকল্পের জন্য নির্দিষ্ট মান হবে)। কোড উদাহরণটি চালানোর জন্য আমরা পরবর্তী ধাপে এই ফাইলটি ব্যবহার করব।

ক্লায়েন্ট লাইব্রেরি সেট আপ করুন

  1. একটি টার্মিনালে, GenerateUserCredentials কোড উদাহরণটি চালান। আপনার ডাউনলোড করা OAuth 2.0 JSON ফাইলটি পাস করার জন্য কমান্ড-লাইন ফ্ল্যাগ ব্যবহার করুন।

    Gradle ব্যবহার করে কমান্ড লাইন থেকে কোড উদাহরণটি চালানোর জন্য আপনি নিম্নলিখিত কমান্ডটি ব্যবহার করতে পারেন:
    ./gradlew --console=plain --quiet runExample \
          --example="authentication.GenerateUserCredentials \
          --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"
        
  2. এই কোড উদাহরণটি আপনাকে এমন একটি URL দেখার জন্য অনুরোধ করবে যেখানে আপনাকে আপনার পক্ষ থেকে আপনার Google বিজ্ঞাপন অ্যাকাউন্ট অ্যাক্সেস করার জন্য অ্যাপটিকে অনুমোদন করতে হবে।

    Paste this URL in your browser:
    https://accounts.google.com/o/oauth2/auth?access_type=offline&client_id=****...
        

    একটি ব্যক্তিগত ব্রাউজার সেশন বা একটি ছদ্মবেশী উইন্ডোতে URL-এ নেভিগেট করুন। Google Ads অ্যাক্সেস করার জন্য আপনি যে Google অ্যাকাউন্ট ব্যবহার করেন তা দিয়ে সাইন ইন করুন। সাধারণত, এটি একটি Google Ads ম্যানেজার অ্যাকাউন্টের লগইন ইমেল যা এর অ্যাকাউন্ট অনুক্রমের অধীনে পরিচালনা করার জন্য প্রয়োজনীয় সমস্ত অ্যাকাউন্ট ধারণ করে। OAuth 2.0 সম্মতি স্ক্রিনে "চালিয়ে যান" এ ক্লিক করুন।

    OAuth 2.0 সম্মতি স্ক্রিন

    আপনাকে একটি পৃষ্ঠায় নিয়ে যাওয়া হবে যেখানে একটি বার্তা দেওয়া হবে যে অনুমোদন সফল হয়েছে।

    Authorization code was successfully retrieved.
    
    Check the console output from `GenerateUserCredentials` for further instructions.
        
  3. আপনি যে কনসোলে কোড উদাহরণটি চালাচ্ছেন সেখানে ফিরে যান। আপনি দেখতে পাবেন যে কোড উদাহরণটি সম্পন্ন হয়েছে এবং আপনার রিফ্রেশ টোকেন এবং কিছু নির্দেশাবলী প্রদর্শন করছে, তারপরে ক্লায়েন্ট লাইব্রেরি কনফিগার করার জন্য আপনাকে যে নির্দেশাবলী অনুসরণ করতে হবে তা অনুসরণ করুন:

        #Mon Apr 18 09:07:51 EDT 2022
        api.googleads.refreshToken=1/Yw.........................................
        api.googleads.clientId=...........-...............apps.googleusercontent.com
        api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE
        api.googleads.clientSecret=........................
        
  4. তারিখ মন্তব্য # থেকে আউটপুটের শেষ পর্যন্ত লাইনগুলি আপনার ads.properties ফাইলে কপি করুন।

    আপনার ডেভেলপার টোকেন দিয়ে INSERT_DEVELOPER_TOKEN_HERE প্রতিস্থাপন করুন।

    সবচেয়ে সহজ সেটআপের জন্য, ads.properties ফাইলটি আপনার হোম ডিরেক্টরিতে রাখুন।