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