এই পৃষ্ঠাটি API ব্যবহার করে কীভাবে সাধারণ কাজগুলি সম্পাদন করতে হয় তার বিশদ প্রদান করে।
ব্যবহারকারী তৈরি করা
UserService প্রশাসক অধিকার সহ একজন ব্যবহারকারীকে তাদের নেটওয়ার্কে সরাসরি একজন ব্যবহারকারী তৈরি করতে দেয়। যেকোন বিকাশকারী নতুন ব্যবহারকারীকে প্রথমে সাইন আপ না করেই এটি করতে পারে৷ উদাহরণ স্বরূপ, আপনি যদি প্রথমবার API ব্যবহার করে দেখেন, প্রশাসক হিসাবে প্রতিটি API কল সম্পাদন করার পরিবর্তে (আপনার ইমেল ঠিকানার জন্য ডিফল্ট), আপনি বিক্রয়কর্মী, পাচারকারী, বা এর মতো ভূমিকা সহ কয়েকটি ব্যবহারকারী তৈরি করতে চাইতে পারেন রিয়েল-ওয়ার্ল্ড ওয়ার্কফ্লো পরীক্ষা করার জন্য বিজ্ঞাপনদাতা।
- কিছু নতুন জিমেইল ঠিকানা তৈরি করুন যেমন
my.name.salesperson@gmail.com। বিকল্পভাবে, একটি নতুন Google অ্যাকাউন্ট হিসাবে একটি বিদ্যমান নন-জিমেইল ঠিকানা নিবন্ধন করুন৷ - সেই নতুন ঠিকানা এবং নির্বাচিত
RoleসহcreateUsersকল করুন। - আপনি আপনার অ্যাক্সেস টোকেন তৈরি করতে OAuth 2.0 ব্যবহার করে সেই নতুন ব্যবহারকারী হিসাবে প্রমাণীকরণ করতে পারেন।
রুট অ্যাডইউনিট পাচ্ছেন
শীর্ষস্থানীয় AdUnit যেটিতে আপনি চাইল্ড নোড যোগ করতে পারেন এবং আপনার অনুক্রমের অনুমোদিত গভীরতা আপনার অ্যাকাউন্টের প্রকারের (ছোট ব্যবসা বা প্রিমিয়াম) উপর নির্ভর করে। শীর্ষস্থানীয় AdUnit যেটি তার চাইল্ড নোডগুলিকে সংশোধন করতে সহায়তা করে তাকে কার্যকর রুট AdUnit বলা হয়।
কার্যকরী রুটটি পুনরুদ্ধার করতে, NetworkService.getCurrentNetwork() কে কল করুন এবং প্রত্যাবর্তিত Network অবজেক্টে effectiveRootAdUnitId ক্ষেত্রটি পরীক্ষা করুন।
দ্রষ্টব্য: বিভিন্ন অ্যাকাউন্টের ধরন বিভিন্ন শ্রেণিবিন্যাস প্যাটার্ন সমর্থন করে।
একটি বস্তুর জন্য অনুসন্ধান
আপনি অনেক পরিষেবা দ্বারা উন্মোচিত get Objects ByStatement() পদ্ধতি ব্যবহার করে অনুসন্ধানের মাপকাঠি দ্বারা বস্তুর জন্য অনুসন্ধান করেন, যেখানে অবজেক্ট একটি নির্দিষ্ট অবজেক্ট টাইপ। এই পদ্ধতিটি একটি পিকিউএল ক্যোয়ারী নেয়, যা একটি এসকিউএল কোয়েরির অনুরূপ যাতে এটি আপনাকে অনুসন্ধান করার জন্য ক্ষেত্রগুলি নির্দিষ্ট করতে দেয় (যেখানে ক্ষেত্রের নামগুলি বস্তুর বৈশিষ্ট্যগুলিতে ম্যাপ করে), বাছাই, সীমাবদ্ধ এবং আপনার অনুসন্ধান ফলাফলগুলি অফসেট করে৷ PQL সম্বন্ধে আরও জানতে PQL গাইড দেখুন, এবং আপনি কোন অবজেক্ট ক্ষেত্রগুলি দ্বারা ফিল্টার করতে পারেন তাও শিখুন।
একটি অর্ডার তৈরি করা
একটি অর্ডার তৈরি করতে, কেবল একটি Order অবজেক্ট তৈরি করুন এবং উপযুক্ত ব্যবহারকারীদের জন্য বিজ্ঞাপনদাতা, বিক্রয়কর্মী এবং পাচারকারী আইডি সেট করুন, একটি অনন্য নাম বরাদ্দ করুন এবং createOrders() কল করুন। ফলাফলে নতুন তৈরি করা Order বা একটি ত্রুটি অন্তর্ভুক্ত থাকবে।
উদাহরণ
একটি অর্ডার তৈরি করার জন্য উদাহরণ জাভা কোড দেখুন।
একটি লাইন আইটেম তৈরি করা
এখানে একটি নতুন লাইন আইটেম তৈরি করার জন্য ধাপগুলি রয়েছে:
- একটি নতুন
Orderঅবজেক্ট তৈরি করুন বা বিদ্যমান একটি ব্যবহার করুন। - একটি নতুন
LineItemঅবজেক্ট তৈরি করুন এবং ঘূর্ণন প্রকার, সৃজনশীল আকার অ্যারে, শুরু এবং শেষের তারিখ এবং অন্যান্য বৈশিষ্ট্য সেট করুন। - একটি নতুন
InventoryTargetingঅবজেক্ট তৈরি করুন এবং কোনPlacementবাAdUnitঅবজেক্টগুলিকে লক্ষ্য বা বাদ দিতে হবে তা নির্দিষ্ট করুন৷ - আপনার
InventoryTargetingঅবজেক্টকে একটি নতুনTargetingঅবজেক্টের ভিতরে মুড়ে দিন এবং এটি আপনারLineItemটার্গেটিং প্রপার্টিতে বরাদ্দ করুন। - আপনার নতুন অবজেক্টের সাথে lineitem পরিষেবা পদ্ধতি
createLineItems()কল করুন এবং আপনার অবজেক্ট তৈরি হয়েছে কিনা তা দেখতে ফলাফল পরীক্ষা করুন।
উদাহরণ
একটি লাইন আইটেম তৈরি করার জন্য উদাহরণ জাভা কোড দেখুন।
ক্রিয়েটিভ তৈরি করা
বিভিন্ন ধরণের ক্রিয়েটিভ বিভিন্ন উপাদান সমর্থন করে: উদাহরণস্বরূপ, একটি চিত্র ক্রিয়েটিভ ছবির জন্য একটি একক উৎস ফাইল সমর্থন করে; একটি ফ্ল্যাশ ক্রিয়েটিভ দুটি অন্তর্নিহিত সম্পদ ফাইল সমর্থন করে: একটি ফ্ল্যাশ ফাইল এবং একটি ব্যাকআপ ইমেজ ফাইল, যদি ফ্ল্যাশ ফাইলটি পরিবেশন করা না যায়। তৃতীয় পক্ষের সাইটগুলিতে হোস্ট করা ক্রিয়েটিভগুলির জন্য, আপনি শুধুমাত্র একটি HTML স্নিপেট আপলোড করবেন যা তৃতীয় পক্ষের সার্ভারে ফাইলটিকে উল্লেখ করে৷ আপনার সৃজনশীল তৈরি করার জন্য আপনাকে কোন সম্পদগুলি আপলোড করতে হবে তা জানতে আপনার নির্দিষ্ট Creative সাবক্লাস দেখুন৷
উদাহরণ
একটি ইমেজ ক্রিয়েটিভ তৈরি করার জন্য উদাহরণ জাভা কোড দেখুন।
একটি বিদ্যমান বস্তুর পরিবর্তন
একটি বিদ্যমান অবজেক্ট পরিবর্তন করতে, get Objects ByStatement() কল করে আপনার অবজেক্টের জন্য ক্যোয়ারী করুন, রিটার্ন করা অবজেক্টের মান আপডেট করুন এবং তারপর update Objects () কল করুন।
দ্রষ্টব্য: আপডেট করা অবজেক্টগুলি বিদ্যমান অবজেক্টগুলিকে সম্পূর্ণরূপে প্রতিস্থাপন করবে, তাই আপনি যে অবজেক্টটি পাঠান তাতে একটি সম্পত্তি মান সেট করতে অবহেলা করলে, সংরক্ষিত বস্তুটি সেই সম্পত্তির জন্য ডিফল্ট মান পাবে, আগের মান নয়।
বস্তুর স্থিতি পরিবর্তন করা
আপনার পরিষেবা দ্বারা উন্মোচিত perform Object Action() পদ্ধতিতে কল করে অবজেক্টের স্থিতি পরিবর্তন করা হয়। এই পদ্ধতি দুটি পরামিতি লাগে:
- অ্যাকশন অবজেক্টের একটি উদাহরণ যা বর্ণনা করে যে আপনি কী করতে চান। উদাহরণ স্বরূপ, অর্ডার সার্ভিসটি
ApproveOrders,PauseOrders, এবংArchiveOrdersসহ বেশ কিছু ক্রিয়া প্রকাশ করে। অ্যাকশন অবজেক্টগুলি আপনার পরিষেবার জন্য উপযুক্ত একটি বেস অ্যাকশন ক্লাস থেকে প্রাপ্ত। - কোন বস্তু পরিবর্তন করতে হবে তা বর্ণনা করে একটি PQL ক্যোয়ারী। আপনি একটি উপযুক্ত PQL বিবৃতি নির্দিষ্ট করে এক সময়ে এক বা একাধিক বস্তুর স্থিতি পরিবর্তন করতে পারেন।
বিজ্ঞাপন ট্যাগ তৈরি করা হচ্ছে
আপনি API ব্যবহার করে বিজ্ঞাপন ট্যাগ তৈরি করতে পারবেন না; পরিবর্তে আপনাকে অবশ্যই Google Ad Manager ওয়েবসাইট ব্যবহার করতে হবে। আরও তথ্যের জন্য ট্যাগিং সহায়তা কেন্দ্র বিভাগটি দেখুন।
আরো উদাহরণ
আপনি আমাদের ক্লায়েন্ট লাইব্রেরির নমুনা কোডে, বিভিন্ন প্রোগ্রামিং ভাষায় আরও অনেক উদাহরণ খুঁজে পেতে পারেন। আপনার প্রোগ্রামিং ভাষার উদাহরণগুলির লিঙ্কের জন্য ক্লায়েন্ট লাইব্রেরি এবং উদাহরণ কোড পৃষ্ঠাটি দেখুন।