আপনি আপনার প্রথম ক্লায়েন্ট অ্যাপ্লিকেশন কোডিং শুরু করার আগে, আপনি যদি সেগুলি ইতিমধ্যে না করে থাকেন তবে আপনাকে কিছু জিনিস করতে হবে।
একটি Google অ্যাকাউন্ট তৈরি করুন এবং অনুসন্ধান বিজ্ঞাপন 360 অনুমতি পান৷
Search Ads 360 API ব্যবহার করার জন্য, আপনার একটি Google অ্যাকাউন্ট এবং Search Ads 360 থেকে সেই অ্যাকাউন্টে দেওয়া উপযুক্ত অনুমতি প্রয়োজন:
আপনার যদি ইতিমধ্যে একটি Google অ্যাকাউন্ট না থাকে তবে একটি তৈরি করুন ৷
একটি Search Ads 360 এজেন্সি ম্যানেজারকে আপনার Google অ্যাকাউন্টের জন্য একটি Search Ads 360 ব্যবহারকারী তৈরি করতে বলুন।
প্রতিবেদনগুলি ডাউনলোড করতে, আপনি যে বিজ্ঞাপনদাতাদের সাথে কাজ করবেন তাদের দেখার অনুমতির প্রয়োজন হবে৷
রূপান্তর যোগ করতে বা সম্পাদনা করতে, আপনি যে বিজ্ঞাপনদাতাদের সাথে কাজ করবেন তাদের সম্পাদনার অনুমতির প্রয়োজন হবে৷ একটি শেয়ার্ড ফ্লাডলাইট কনফিগারেশনে , আপনি প্রতিটি চাইল্ড বিজ্ঞাপনদাতার জন্য সম্পাদনার অনুমতি প্রয়োজন যাতে আপনি রূপান্তরগুলি আপলোড করতে চান৷ আপনার অভিভাবক বিজ্ঞাপনদাতার অ্যাক্সেসের প্রয়োজন নেই, বা আপনার এমন শিশু বিজ্ঞাপনদাতাদের অ্যাক্সেসের প্রয়োজন নেই যেগুলিতে আপনি রূপান্তরগুলি আপলোড করছেন না৷ আপনি যদি ক্লিক আইডি ব্যবহার করেন ভিজিটগুলিতে রূপান্তরগুলিকে অ্যাট্রিবিউট করার জন্য, নিশ্চিত করুন যে আপনার কাছে সেই বিজ্ঞাপনদাতার সম্পাদনা অ্যাক্সেস রয়েছে যা ক্লিক আইডি তৈরি করেছে৷ আপনি যদি কোনো বিজ্ঞাপনদাতার কাছ থেকে একটি ক্লিক আইডি উল্লেখ করেন যেখানে আপনার সম্পাদনার অ্যাক্সেস নেই, অনুরোধটি সফল হবে না।
এজেন্সি ম্যানেজার নির্দিষ্ট বিজ্ঞাপনদাতাদের অ্যাক্সেস সহ একটি বিজ্ঞাপনদাতা ব্যবহারকারী হিসাবে আপনার অ্যাকাউন্ট সেট আপ করতে পারেন, বা এজেন্সির সমস্ত বিজ্ঞাপনদাতাদের অ্যাক্সেস সহ এজেন্সি ব্যবহারকারীর মতো উচ্চ স্তরের অ্যাক্সেস সহ আপনার অ্যাকাউন্ট সেট আপ করতে পারেন।
API রূপান্তর পরিষেবা সক্রিয় করুন
আপনি যদি রূপান্তর সম্পর্কে ডেটা আপলোড করতে চান, এজেন্সি ম্যানেজার বিশেষাধিকার সহ একজন অনুসন্ধান বিজ্ঞাপন 360 ব্যবহারকারীকে অনুসন্ধান বিজ্ঞাপন 360 UI-তে সাইন ইন করতে হবে এবং API রূপান্তর পরিষেবা সক্রিয় করতে হবে । নির্দেশাবলীর জন্য Search Ads 360 সহায়তা কেন্দ্র দেখুন।
আপনার ক্লায়েন্টের জন্য একটি Google API কনসোল প্রকল্প এবং OAuth শংসাপত্র তৈরি করুন৷
- Google API কনসোল সেটআপ টুল শুরু করুন।
সেটআপ টুল আপনাকে একটি প্রজেক্ট তৈরি করার (অথবা একটি বিদ্যমান প্রোজেক্ট ব্যবহার করে), Search Ads 360 API সক্ষম করে এবং OAuth 2.0 ক্রেডেনশিয়াল তৈরি করার জন্য গাইড করে। - আপনার আবেদন নিবন্ধন পৃষ্ঠায়, একটি বিদ্যমান প্রকল্প নির্বাচন করুন বা একটি প্রকল্প তৈরি করুন নির্বাচন করুন। তারপর Continue এ ক্লিক করুন।
- Google API কনসোল অনুসন্ধান বিজ্ঞাপন 360 API সক্ষম করার পরে, শংসাপত্রগুলিতে যান বোতামে ক্লিক করুন৷
- শংসাপত্র তৈরি করুন পৃষ্ঠায়, নিম্নলিখিত তথ্য লিখুন:
- আপনি কোন API ব্যবহার করছেন? : অনুসন্ধান বিজ্ঞাপন 360 API
- আপনি কি তথ্য অ্যাক্সেস করা হবে? : ব্যবহারকারী তথ্য
- Next বাটনে ক্লিক করুন।
সেটআপ টুল এখন আপনাকে একটি OAuth 2.0 ক্লায়েন্ট আইডি তৈরি করতে সহায়তা করার প্রস্তাব দেয়।
- সেটআপ টুলের বাকি ধাপগুলো অনুসরণ করুন।
sa360Api.py ইনস্টল করুন
সার্চ বিজ্ঞাপন 360 অনুমোদন সেট আপ করার প্রক্রিয়া সহজতর করার জন্য একটি ইউটিলিটি স্ক্রিপ্ট প্রদান করে। আপনি এই স্ক্রিপ্টটি JSON ফর্ম্যাটে ডেটা পাঠাতে এবং গ্রহণ করতে ব্যবহার করতে পারেন, যদি আপনি একটি সম্পূর্ণ অ্যাপ্লিকেশন ডিজাইন এবং লেখার আগে ডেটা পাঠানো এবং গ্রহণ করার চেষ্টা করতে চান। আপনি এই ডকুমেন্টেশন সাইটে অনেক JSON উদাহরণ কপি করতে পারেন এবং সরাসরি স্ক্রিপ্টে ইনপুট করতে পারেন।
স্ক্রিপ্ট ইনস্টল করতে:
- পাইথন 2.7 ইনস্টল করুন ।
স্ক্রিপ্ট Python 3.x এর সাথে কাজ করে না। - CURL ইনস্টল করুন ।
- sa360Api.zip ডাউনলোড করুন ।
-
sa360Api.zipথেকেsa360Api.pyবের করুন। -
sa360Api.pyএক্সিকিউটেবল করুন।
REST বেসিক শিখুন
API চালু করার দুটি উপায় রয়েছে:
- ক্লায়েন্ট লাইব্রেরি ব্যবহার করে।
- HTTP অনুরোধ পাঠানো এবং প্রতিক্রিয়া পার্সিং.
আপনি যদি ক্লায়েন্ট লাইব্রেরি ব্যবহার না করার সিদ্ধান্ত নেন, তাহলে আপনাকে REST এর মূল বিষয়গুলি বুঝতে হবে।
REST হল সফ্টওয়্যার আর্কিটেকচারের একটি শৈলী যা ডেটা অনুরোধ এবং পরিবর্তন করার জন্য একটি সুবিধাজনক এবং সামঞ্জস্যপূর্ণ পদ্ধতি প্রদান করে।
REST শব্দটি " রিপ্রেজেন্টেশনাল স্টেট ট্রান্সফার " এর জন্য সংক্ষিপ্ত। Google API-এর প্রসঙ্গে, এটি Google দ্বারা সংরক্ষিত ডেটার উপস্থাপনা পুনরুদ্ধার এবং সংশোধন করার জন্য HTTP ক্রিয়া ব্যবহারকে বোঝায়।
একটি RESTful সিস্টেমে, সম্পদ একটি ডেটা স্টোরে সংরক্ষণ করা হয়; একটি ক্লায়েন্ট একটি অনুরোধ পাঠায় যে সার্ভার একটি নির্দিষ্ট ক্রিয়া সম্পাদন করে (যেমন একটি সংস্থান তৈরি করা, পুনরুদ্ধার করা, আপডেট করা বা মুছে ফেলা), এবং সার্ভার ক্রিয়াটি সম্পাদন করে এবং একটি প্রতিক্রিয়া পাঠায়, প্রায়শই নির্দিষ্ট সংস্থানের উপস্থাপনা আকারে।
Google-এর RESTful API-এ, ক্লায়েন্ট একটি HTTP ক্রিয়া যেমন POST , GET , PUT , বা DELETE ব্যবহার করে একটি ক্রিয়া নির্দিষ্ট করে৷ এটি নিম্নলিখিত ফর্মের একটি বিশ্বব্যাপী-অনন্য URI দ্বারা একটি সংস্থান নির্দিষ্ট করে:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
যেহেতু সমস্ত API সংস্থানগুলিতে অনন্য HTTP- অ্যাক্সেসযোগ্য URI রয়েছে, REST ডেটা ক্যাশিং সক্ষম করে এবং ওয়েবের বিতরণ করা অবকাঠামোর সাথে কাজ করার জন্য অপ্টিমাইজ করা হয়৷
আপনি HTTP 1.1 স্ট্যান্ডার্ড ডকুমেন্টেশনে পদ্ধতির সংজ্ঞাগুলি দরকারী খুঁজে পেতে পারেন; তারা GET , POST , PUT , এবং DELETE এর স্পেসিফিকেশন অন্তর্ভুক্ত করে।
অনুসন্ধান বিজ্ঞাপন 360 API-এ বিশ্রাম নিন
Search Ads 360 API অপারেশনগুলি সরাসরি REST HTTP ক্রিয়াকে ম্যাপ করে।
Search Ads 360 API URI-এর জন্য নির্দিষ্ট ফর্ম্যাট হল:
https://www.googleapis.com/doubleclicksearch/v2/resourcePath?parameters
API-এ প্রতিটি সমর্থিত অপারেশনের জন্য ব্যবহৃত URI-এর সম্পূর্ণ সেট API রেফারেন্সে সংক্ষিপ্ত করা হয়েছে।
JSON বেসিক শিখুন
আপনি যদি REST ব্যবহার করেন, তাহলে অনুরোধ সংস্থাগুলির জন্য আপনাকে JSON ফর্ম্যাট ব্যবহার করতে হবে। আপনি উল্লেখ করতে পারেন যে প্রতিক্রিয়াগুলি হয় JSON বা CSV ফর্ম্যাটে।
JSON (জাভাস্ক্রিপ্ট অবজেক্ট নোটেশন) হল একটি সাধারণ, ভাষা-স্বাধীন ডেটা ফর্ম্যাট যা নির্বিচারে ডেটা স্ট্রাকচারের একটি সাধারণ পাঠ্য উপস্থাপনা প্রদান করে। আরও তথ্যের জন্য, json.org দেখুন।