পটভূমি

আপনি শুরু করার আগে

  1. আপনার অ্যাকাউন্টের প্রতিনিধিকে আপনার অ্যাপ্লিকেশন অ্যাক্সেস করা অ্যাকাউন্টগুলির জন্য যথাযথ অনুমতি সেট আপ করতে বলুন।
  2. আপনি যদি অনুমোদিত ক্রেতাদের ধারণার সাথে অপরিচিত হন তবে অনুমোদিত ক্রেতাদের সহায়তা কেন্দ্রে যান এবং ব্যবহারকারী ইন্টারফেসের সাথে পরীক্ষা করুন৷ যদি আপনার আবেদনটি রিয়েল-টাইম বিডিং করার প্রত্যাশিত হয়, তাহলে RTB প্রোটোকল ডকুমেন্টেশন পড়ুন।
  3. একটি নতুন প্রকল্প সেট আপ করতে APIs কনসোলে যান৷ হয় আপনার বিকাশকারী Google অ্যাকাউন্টে সাইন ইন করুন বা একটি অ্যাকাউন্ট তৈরি করুন৷ তারপরে আপনাকে একটি প্রকল্প তৈরি করতে এবং কয়েকটি পরিষেবার শর্তাবলীতে সাইন অফ করতে বলা হবে৷

পিতামাতা এবং সন্তানের অ্যাকাউন্ট

আপনি যদি পিতামাতা এবং সন্তানের অ্যাকাউন্ট সমন্বিত একটি অ্যাকাউন্ট কাঠামোর মধ্যে কাজ করেন তবে তারা কীভাবে ইন্টারঅ্যাক্ট করে তা আপনি বুঝতে পারলে আপনি আরও কার্যকরভাবে কাজ করতে সক্ষম হবেন। নিম্নলিখিত একটি সংক্ষিপ্ত সারসংক্ষেপ:

শিশু অ্যাকাউন্ট

শংসাপত্র সহ একজন ব্যবহারকারী যা একটি শিশু অ্যাকাউন্টে অ্যাক্সেস মঞ্জুর করে শুধুমাত্র তাদের অ্যাকাউন্টের সাথে সম্পর্কিত সংস্থানগুলি দেখতে এবং সংশোধন করতে পারে৷ চাইল্ড অ্যাকাউন্টগুলি অন্য শিশু বা পিতামাতার অ্যাকাউন্টগুলির সাথে সম্পর্কিত সংস্থানগুলি দেখতে বা সংশোধন করতে পারে না৷

পিতামাতার অ্যাকাউন্ট

শংসাপত্র সহ একজন ব্যবহারকারী যা একটি পিতামাতার অ্যাকাউন্টে অ্যাক্সেস মঞ্জুর করে সে সমস্ত সম্পর্কিত শিশু অ্যাকাউন্টগুলি ছাড়াও পিতামাতার অ্যাকাউন্টের জন্য সংস্থানগুলি দেখতে এবং সংশোধন করতে পারে৷ প্রদত্ত সমস্ত সংস্থান তালিকাভুক্ত অপারেশনগুলির জন্য, এই ব্যবহারকারী তাদের অ্যাকাউন্ট এবং তাদের সমস্ত চাইল্ড অ্যাকাউন্টের ডেটা সহ একটি প্রতিক্রিয়া পাবেন। মনে রাখবেন যে চাইল্ড সিটের জন্য রিসোর্স টার্গেট করে অন্য ধরনের অনুরোধের জন্য, একটি অভিভাবক অ্যাকাউন্টকে তাদের নিজস্ব accountId এর পরিবর্তে চাইল্ড অ্যাকাউন্টের জন্য একটি accountId পাথ প্যারামিটার নির্দিষ্ট করতে হবে।

REST API ডেটা মডেল

একটি সম্পদ একটি অনন্য শনাক্তকারী সহ একটি পৃথক ডেটা সত্তা। অ্যাকাউন্ট রিসোর্স একটি অনুমোদিত ক্রেতাদের অ্যাকাউন্ট এন্ট্রি প্রতিনিধিত্ব করে, এবং এটি Ad Exchange Buyer API-এর জন্য রুট ডেটা ক্লাস। API-এর পদ্ধতিগুলি পৃথক অ্যাকাউন্ট সংস্থান এবং অ্যাকাউন্ট সংস্থানগুলির সংগ্রহের উপর কাজ করে।

একটি অ্যাকাউন্ট রিসোর্স অন্তর্ভুক্ত করে: একটি অ্যাকাউন্ট আইডি, কুকি মেলাতে ব্যবহৃত তথ্য, দরদাতার অবস্থান, যে URL-এ বিড অনুরোধ পাঠানো হয়, এবং বিজ্ঞাপন এক্সচেঞ্জ দ্বারা পাঠানো প্রতি সেকেন্ডে সর্বাধিক ক্যোয়ারী নির্দিষ্ট করার অনুরোধ।

অ্যাকাউন্ট রিসোর্স এবং সংগ্রহ ছাড়াও, Ad Exchange Buyer API নিম্নলিখিত ডেটা স্ট্রাকচারগুলিকে সংজ্ঞায়িত করে:

দরদাতার অবস্থান

দরদাতার অবস্থানগুলি হল এমন কাঠামো যা অ্যাকাউন্টস রিসোর্স সহ ফেরত দেওয়া হয় URL প্রদান করার জন্য যেখানে বিজ্ঞাপন এক্সচেঞ্জকে বিড অনুরোধ পাঠাতে হবে এবং প্রতি সেকেন্ডে সর্বাধিক সংখ্যক ক্যোয়ারী বিজ্ঞাপন এক্সচেঞ্জ পাঠাতে হবে। এখানে একটি দরদাতার অবস্থানের একটি উদাহরণ রয়েছে, যা JSON-এ প্রকাশ করা হয়েছে:

"bidderLocation": [
    {
      "url": "http://bid.url.com/bidder",
      "maximumQps": 1500
    }
  ],

আইটেম

আইটেম অ্যাকাউন্টের একটি তালিকা প্রদান করে. এখানে JSON-এ প্রকাশিত আইটেমগুলির একটি উদাহরণ রয়েছে:

{
  "kind": "adexchangebuyer#accountsList",
  "items": [
    accounts Resource
  ]
}

সমর্থিত অপারেশন

আপনি নিম্নলিখিত সারণীতে বর্ণিত অ্যাড এক্সচেঞ্জ ক্রেতা API-তে সংগ্রহ এবং সংস্থানগুলির জন্য তিনটি ভিন্ন পদ্ধতি ব্যবহার করতে পারেন। সমস্ত অপারেশন অনুমোদন প্রয়োজন.

অপারেশন বর্ণনা REST HTTP ম্যাপিং
তালিকা বর্তমানে প্রমাণীকৃত ব্যবহারকারী দ্বারা অ্যাক্সেস করা যেতে পারে এমন সমস্ত অ্যাকাউন্টের তালিকা করুন৷ একটি সংগ্রহ URI এ GET ।
পেতে একটি নির্দিষ্ট অ্যাকাউন্ট সম্পদ পায়। একটি রিসোর্স ইউআরআই GET ।
আপডেট একটি নির্দিষ্ট অ্যাকাউন্ট রিসোর্স আপডেট করে। একটি রিসোর্স ইউআরআইতে PUT , যেখানে আপনি আপডেট করা রিসোর্সের জন্য ডেটা পাস করেন।

কলিং স্টাইল

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 এর স্পেসিফিকেশন অন্তর্ভুক্ত করে।

Ad Exchange Buyer API-এ REST

সমর্থিত ক্রিয়াকলাপগুলি সরাসরি REST HTTP ক্রিয়াগুলিতে ম্যাপ করে, যেমন API অপারেশনগুলিতে বর্ণিত হয়েছে।

API URI-এর জন্য নির্দিষ্ট বিন্যাস হল:

https://www.googleapis.com/adexchangebuyer/v1.4/resourceID?parameters

যেখানে resourceID হল একটি অ্যাকাউন্টস রিসোর্সের শনাক্তকারী এবং parameters হল কোয়েরিতে প্রযোজ্য যেকোন প্যারামিটার। বিস্তারিত জানার জন্য স্ট্যান্ডার্ড কোয়েরি প্যারামিটার এবং রেফারেন্স ডকুমেন্টেশন দেখুন।

resourceID পাথ এক্সটেনশনের ফর্ম্যাট আপনাকে বর্তমানে আপনি যে সংস্থানটি পরিচালনা করছেন তা সনাক্ত করতে দেয়, উদাহরণস্বরূপ:

https://www.googleapis.com/adexchangebuyer/v1.4/accounts
https://www.googleapis.com/adexchangebuyer/v1.4/accounts/id

API-এ প্রতিটি সমর্থিত অপারেশনের জন্য ব্যবহৃত URI-এর সম্পূর্ণ সেট রেফারেন্স ডকুমেন্টেশনে সংক্ষিপ্ত করা হয়েছে।

Ad Exchange Buyer API-এ এটি কীভাবে কাজ করে তার একটি উদাহরণ এখানে দেওয়া হল।

অ্যাকাউন্টের প্রমাণীকৃত ব্যবহারকারীর তালিকা পান: 

GET https://www.googleapis.com/adexchangebuyer/v1.4/accounts

ডেটা বিন্যাস

JSON

JSON (জাভাস্ক্রিপ্ট অবজেক্ট নোটেশন) হল একটি সাধারণ, ভাষা-স্বাধীন ডেটা ফর্ম্যাট যা নির্বিচারে ডেটা স্ট্রাকচারের একটি সাধারণ পাঠ্য উপস্থাপনা প্রদান করে। আরও তথ্যের জন্য, json.org দেখুন।