গুগল অ্যাডস এপিআই আপনার গুগল অ্যাডস অ্যাকাউন্টের সাথে ইউটিউব ভিডিও লিঙ্ক করা সমর্থন করে। এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে এপিআই ব্যবহার করে আপনার অ্যাকাউন্টে লিঙ্ক যুক্ত এবং অপসারণ করা যায়।
ভিডিও লিঙ্ক করুন
কে প্রক্রিয়াটি শুরু করছে তার উপর নির্ভর করে, ভিডিও দুটি উপায়ের যেকোনো একটিতে আপনার অ্যাকাউন্টের সাথে লিঙ্ক করা যেতে পারে:
- আপনি আপনার অ্যাকাউন্টের সাথে একটি ভিডিও লিঙ্ক করার জন্য অনুরোধ করেন। এক্ষেত্রে, আপনি একজন ক্রিয়েটরের কাছে একটি অনুরোধ পাঠান, যা তাদের ভিডিওর সাথে লিঙ্কটি স্থাপন করার জন্য অবশ্যই গ্রহণ করতে হবে। অনুরোধটি গৃহীত হওয়ার আগে আপনি তা প্রত্যাহার করতে পারেন এবং গৃহীত হওয়ার পরেও লিঙ্ক করা ভিডিওটি সরিয়ে ফেলতে পারেন।
- ভিডিওটির নির্মাতা আপনার গুগল অ্যাডস অ্যাকাউন্টের সাথে তাদের ভিডিওটি লিঙ্ক করার জন্য অনুরোধ করেন। এরপর আপনি তাদের অনুরোধটি গ্রহণ বা প্রত্যাখ্যান করতে পারেন।
প্রতিটি পরিস্থিতিতে নিম্নলিখিত পদ্ধতিগুলো ব্যবহার করা হয়:
| দৃশ্যকল্প | পদক্ষেপ | মন্তব্য |
|---|---|---|
| দৃশ্যকল্প ১ | ইউটিউব এপিআই থেকে ভিডিওর তথ্য নিন। | যে চ্যানেলে ভিডিও লিঙ্কের অনুরোধ পাঠাতে চান, সেই channel_id অথবা আপনি যে ভিডিওটি লিঙ্ক করতে চান তার video_id পেতে ইউটিউব এপিআই (YouTube API) ব্যবহার করুন। কোনো ভিডিওর ইউআরএল (URL) থেকে "v=" পরের ১১টি অক্ষর নিয়েও video_id আইডিটি পাওয়া যায়। |
| একটি লিঙ্ক অনুরোধ তৈরি করুন | একটি লিঙ্ক অনুরোধ তৈরি করতে DataLinkService.CreateDataLink মেথডটি ব্যবহার করুন। ভিডিওটির সাথে যুক্ত চ্যানেলটি স্পষ্টভাবে শনাক্ত করার জন্য আপনি ঐচ্ছিকভাবে youtube_video.channel_id উল্লেখ করতে পারেন। DataLink এর status সেট করা উচিত নয়; এপিআই কলটি সফলভাবে সম্পন্ন হলে Google Ads API সার্ভার এটিকে REQUESTED এ সেট করে দেবে। | |
| একটি অনুরোধের অবস্থা যাচাই করুন | data_link রিসোর্সটি কোয়েরি করতে এবং এর status যাচাই করতে GoogleAdsService.SearchStream অথবা GoogleAdsService.Search ব্যবহার করুন। | |
| অনুরোধ প্রত্যাহার করুন | DataLinkService.UpdateDataLink মেথডটি ব্যবহার করে DataLink এর status REQUESTED থেকে REVOKED এ পরিবর্তন করার মাধ্যমে একটি লিঙ্ক রিকোয়েস্ট প্রত্যাহার করা যায়। | |
| একটি লিঙ্ক সরান | লিঙ্ক করা ভিডিও মুছে ফেলার জন্য DataLinkService.RemoveDataLink ব্যবহার করুন। | |
| দৃশ্যকল্প ২ | একটি আমন্ত্রণ পুনরুদ্ধার করুন | data_link রিসোর্সটি কোয়েরি করতে GoogleAdsService.Search অথবা GoogleAdsService.SearchStream ব্যবহার করুন। গ্রহণ বা প্রত্যাখ্যান করার জন্য লিঙ্ক রিকোয়েস্টগুলো খুঁজে পেতে status = PENDING_APPROVAL দিয়ে ফিল্টার করুন। |
| লিঙ্ক অনুরোধ গ্রহণ বা প্রত্যাখ্যান করুন | অনুরোধটি গ্রহণ করতে DataLink এর স্ট্যাটাস ENABLED এবং প্রত্যাখ্যান করতে REJECTED এ আপডেট করার জন্য DataLinkService.UpdateDataLink মেথডটি ব্যবহার করুন। |
লিঙ্কের বিবরণ পুনরুদ্ধার করুন
আপনি data_link রিসোর্সটি কোয়েরি করার জন্য GoogleAdsService.Search অথবা GoogleAdsService.SearchStream ব্যবহার করতে পারেন। নিম্নলিখিত কোয়েরিটি ইউটিউব চ্যানেল আইডি সহ ইউটিউব ভিডিও লিঙ্কের বিবরণ পুনরুদ্ধার করে।
SELECT
data_link.resource_name,
data_link.status,
data_link.youtube_video.video_id,
data_link.youtube_video.channel_id
FROM data_link
WHERE data_link.type = 'VIDEO'
এই ওয়ার্কফ্লোতে নিম্নলিখিত সাধারণ ত্রুটিগুলো দেখা দিতে পারে:
| ত্রুটি কোড | ব্যাখ্যা |
|---|---|
DataLinkError.PERMISSION_DENIED | গ্রাহকের এই কাজটি করার অনুমতি নেই। |
DataLinkError.YOUTUBE_VIDEO_ID_INVALID | ভিডিও আইডিটি অবৈধ হওয়ায় একটি ভিডিও লিঙ্ক তৈরি করা যায়নি। |