সার্চ বিজ্ঞাপন 360 এপিআই প্রমাণীকরণের জন্য একটি OAuth 2.0 অ্যাক্সেস টোকেন নির্দিষ্ট করার জন্য সমস্ত অনুরোধের প্রয়োজন। টোকেন জেনারেট করতে এবং Search Ads 360 API-এ পাস করতে আপনি যেকোনও স্ট্যান্ডার্ড OAuth 2.0 প্রমাণীকরণ ওয়ার্কফ্লো অনুসরণ করতে পারেন। আমরা নীচে বর্ণিত ওয়ার্কফ্লো সুপারিশ করি কারণ এটি সম্পূর্ণ স্বয়ংক্রিয় রূপান্তর আপলোড এবং প্রতিবেদন ডাউনলোডের জন্য উপযুক্ত৷
নীচে বর্ণিত কর্মপ্রবাহের বিকল্পগুলির জন্য, ইনস্টল করা অ্যাপ্লিকেশনগুলির জন্য OAuth 2.0 ব্যবহার করা বা সার্ভার থেকে সার্ভার অ্যাপ্লিকেশনগুলির জন্য OAuth 2.0 ব্যবহার করা দেখুন৷ আপনি যদি একটি বিকল্প ওয়ার্কফ্লো ব্যবহার করেন, আপনি যখন একটি OAuth 2.0 অনুমোদন কোড অনুরোধ করেন তখন scope প্যারামিটার হিসাবে নিম্নলিখিত মানটি নির্দিষ্ট করুন:
https://www.googleapis.com/auth/doubleclicksearch
আপনি সার্ভার থেকে সার্ভার রুট অনুসরণ করলে, সার্চ বিজ্ঞাপন 360 ব্যবহারকারী হিসেবে পরিষেবা অ্যাকাউন্ট যোগ করুন।
প্রস্তাবিত অনুমোদন কর্মপ্রবাহ
- Google API কনসোলে যান এবং আপনার প্রকল্প নির্বাচন করুন।
আপনি যদি ইতিমধ্যে একটি Google API কনসোল প্রকল্প এবং OAuth শংসাপত্র তৈরি না করে থাকেন, তাহলে আপনার ক্লায়েন্টের জন্য একটি Google API কনসোল প্রকল্প এবং OAuth শংসাপত্র তৈরি করুন এর নির্দেশাবলী অনুসরণ করুন৷
আপনার প্রকল্পের OAuth ক্লায়েন্ট আইডি এবং গোপনীয়তা খুঁজে পেতে, নিম্নলিখিতগুলি করুন:
- শংসাপত্র পৃষ্ঠা খুলুন.
- নাম কলামে, আপনার OAuth ক্লায়েন্টের নামে ক্লিক করুন।
- ক্লায়েন্ট আইডি এবং গোপনীয়তা পৃষ্ঠায় তালিকাভুক্ত করা হয়েছে।
- একটি ওয়েব ব্রাউজার খুলুন এবং অনুসন্ধান বিজ্ঞাপন 360-এ ডেটা অ্যাক্সেস করার অনুমতি আছে এমন একটি Google অ্যাকাউন্ট দিয়ে Google-এ সাইন ইন করুন ।
এই Google অ্যাকাউন্টটি আপনার API ক্লায়েন্ট সার্চ বিজ্ঞাপন 360 এর সাথে প্রমাণীকরণের জন্য ব্যবহার করবে। যদি Google অ্যাকাউন্ট ধারক আপনার কোম্পানি ছেড়ে যান এবং আপনি অ্যাকাউন্ট থেকে Search Ads 360 অ্যাক্সেস সরিয়ে দেন, তাহলে আপনাকে এই অনুমোদনের কার্যপ্রবাহ পুনরাবৃত্তি করতে হবে এবং একটি ভিন্ন Google অ্যাকাউন্ট নির্দিষ্ট করতে হবে .
- নিম্নলিখিত হিসাবে অনুসন্ধান বিজ্ঞাপন 360 ইউটিলিটি স্ক্রিপ্ট আহ্বান করে একটি রিফ্রেশ টোকেন পান:
sa360Api.py --loginস্ক্রিপ্টটি আপনাকে একটি রিফ্রেশ টোকেন পেতে Oauth ক্লায়েন্ট আইডি এবং গোপন ব্যবহার করার প্রক্রিয়ার মধ্য দিয়ে নিয়ে যায়। রিফ্রেশ টোকেনটি শুধুমাত্র সেই Google অ্যাকাউন্টের জন্য বৈধ যা আপনি আগের ধাপে সাইন ইন করেছিলেন৷
এই প্রক্রিয়ার অংশ হিসাবে, স্ক্রিপ্ট একটি URL তৈরি করে এবং আপনাকে একটি ওয়েব ব্রাউজারে URL দেখার জন্য নির্দেশ দেয়।
যখন ব্রাউজার আপনাকে OAuth ক্লায়েন্টকে Search Ads 360 ডেটা অ্যাক্সেস করার অনুমতি দিতে বলে, তখন নিশ্চিত করুন যে আপনি আগে সাইন-ইন করেছেন সেই Google অ্যাকাউন্টটি দেখা যাচ্ছে। (যদি আপনি একাধিক Google অ্যাকাউন্টে সাইন ইন করে থাকেন, তাহলে আপনাকে একটি ভিন্ন অ্যাকাউন্ট দিয়ে উপস্থাপন করা হতে পারে।)
প্রক্রিয়া শেষে,
sa360Api.pyস্ক্রিপ্ট একটি কমা-ডিলিমিটেড স্ট্রিং আউটপুট করে। প্রথম মান হল আপনার দেওয়া ক্লায়েন্ট আইডি, দ্বিতীয় মান হল আপনার দেওয়া ক্লায়েন্ট সিক্রেট, এবং তৃতীয় মান হল রিফ্রেশ টোকেন। নিম্নলিখিত উদাহরণের আউটপুটে, রিফ্রেশ টোকেনটি বোল্ড টেক্সটে রয়েছে:
123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef, 1/HIJklM01OPQR23NOP456rst890uvw- ক্লায়েন্ট আইডি, ক্লায়েন্ট সিক্রেট এবং রিফ্রেশ টোকেন একটি ব্যাকএন্ড ডাটাবেস বা আপনার অ্যাপ্লিকেশনে অ্যাক্সেসযোগ্য অন্য নিরাপদ স্থানে সংরক্ষণ করুন।
সার্চ বিজ্ঞাপন 360 এপিআই-এ নমুনা JSON অনুরোধ পাঠানোর জন্য আপনি
sa360Api.pyব্যবহার করার পরিকল্পনা করলে সম্পূর্ণ কমা-ডিলিমিটেড স্ট্রিংটিকে একটি সুবিধাজনক স্থানে রাখুন। আপনি প্রতিবার স্ক্রিপ্টটি চালু করার সময় একটি প্যারামিটার হিসাবে পুরো স্ট্রিংটি পাস করবেন। - আপনার অ্যাপ্লিকেশনে কোড যোগ করুন যা নিম্নলিখিতগুলি করে:
- একটি নতুন OAuth 2.0 অ্যাক্সেস টোকেন পেতে ক্লায়েন্ট আইডি, ক্লায়েন্ট সিক্রেট এবং রিফ্রেশ টোকেন ব্যবহার করুন।
- নতুন অ্যাক্সেস টোকেন ব্যবহার করে Search Ads 360 API-এ অনুরোধ পাঠান।
আপনি যদি ক্লায়েন্ট লাইব্রেরিগুলি ব্যবহার করেন, তাহলে পরবর্তী বিভাগ, আপনার অ্যাপ্লিকেশন সেট আপ করুন , আপনার অ্যাপ্লিকেশনে এই অনুমোদন কোডটি কীভাবে যুক্ত করবেন তা বর্ণনা করে।
আপনি যদি ক্লায়েন্ট লাইব্রেরিগুলির একটি ব্যবহার না করেন, তাহলে একটি নতুন অ্যাক্সেস টোকেন পাওয়ার পরামর্শের জন্য ইনস্টল করা অ্যাপ্লিকেশনগুলির জন্য OAuth 2.0 ব্যবহার করা দেখুন৷