YouTube লিঙ্ক করা

Google Ads API-এর মাধ্যমে আপনার Google Ads অ্যাকাউন্টে YouTube ভিডিও লিঙ্ক করা যায়। এই নির্দেশিকা আপনার অ্যাকাউন্টে লিঙ্ক যোগ করতে এবং সরাতে কীভাবে API ব্যবহার করবেন তা ব্যাখ্যা করে।

কে প্রসেস শুরু করছেন তার উপর নির্ভর করে, দুটি উপায়ের মধ্যে যেকোনও একটি উপায়ে আপনার অ্যাকাউন্টের সাথে ভিডিও লিঙ্ক করা যেতে পারে, হয়:

  1. আপনি কোনও ভিডিও আপনার অ্যাকাউন্টের সাথে লিঙ্ক করার অনুরোধ করেন। এই পরিস্থিতিতে, আপনি ক্রিয়েটরকে অনুরোধ পাঠান এবং তার ভিডিওর সাথে লিঙ্ক করার জন্য তাকে সেই অনুরোধ গ্রহণ করতে হয়। আপনি এমন অনুরোধ প্রত্যাহার করতে পারেন যা গ্রহণ করার আগে বাড়িয়ে দেওয়া হয়েছে এবং এটি গ্রহণ করার পরে লিঙ্ক করা ভিডিও সরিয়ে দিতে পারেন।
  2. ভিডিওর ক্রিয়েটর তার ভিডিও আপনার Google Ads অ্যাকাউন্টের সাথে লিঙ্ক করার অনুরোধ করেছেন। আপনি তারপর তাদের অনুরোধ গ্রহণ বা বাতিল করার বিকল্প বেছে নিতে পারবেন।

প্রতিটি পরিস্থিতিতে নিম্নলিখিত পদ্ধতি ব্যবহার করা হয়:

পরিস্থিতি অ্যাকশন মতামত
পরিস্থিতি ১ YouTube API থেকে ভিডিওর তথ্য পাওয়া YouTube API ব্যবহার করে channel_id পান, যাতে ভিডিও লিঙ্ক করার অনুরোধ পাঠানো যায় এবং যে ভিডিও লিঙ্ক করতে চান সেটির video_id পান। video_id হল YouTube ভিডিও URL-এ থাকা ১১-অক্ষরের স্ট্রিং (যেমন, www.youtube.com/watch?v=VIDEO_ID-এ v প্যারামিটার বা youtu.be/VIDEO_ID-এ পাথ)।
লিঙ্ক করার অনুরোধ তৈরি করা DataLinkService.CreateDataLink পদ্ধতি ব্যবহার করে লিঙ্ক করার অনুরোধ তৈরি করুন, ভিডিও এবং তার সাথে যুক্ত চ্যানেল শনাক্ত করতে youtube_video.channel_id এবং youtube_video.video_id দুটিই উল্লেখ করুন। v24 থেকে শুরু করে, আপনি youtube_link_metadata.brand_channel_id নির্দিষ্ট করতে পারেন যাতে লিঙ্ক করা YouTube ব্র্যান্ড চ্যানেলের আইডি প্রদান করা যায় এবং ক্রিয়েটররা আপনার ব্র্যান্ড সম্পর্কে বুঝতে পারেন। DataLink-এর status সেট করা উচিত নয়; API কল সফলভাবে সম্পূর্ণ হলে Google Ads API সার্ভার এটিকে REQUESTED-এ সেট করবে।
অনুরোধের স্ট্যাটাস পরীক্ষা করা data_link রিসোর্স কোয়েরি করতে এবং এর status পরীক্ষা করতে GoogleAdsService.SearchStream অথবা GoogleAdsService.Search ব্যবহার করুন।
অনুরোধ প্রত্যাহার করা DataLink-এর status REQUESTED থেকে REVOKED-এ পরিবর্তন করে লিঙ্ক করার অনুরোধ প্রত্যাহার করতে DataLinkService.UpdateDataLink পদ্ধতি ব্যবহার করুন।
লিঙ্ক সরানো লিঙ্ক করা ভিডিও সরাতে DataLinkService.RemoveDataLink ব্যবহার করুন।
পরিস্থিতি ২ আমন্ত্রণ ফিরিয়ে আনা data_link রিসোর্স কোয়েরি করতে GoogleAdsService.Search বা GoogleAdsService.SearchStream ব্যবহার করুন। লিঙ্ক করার অনুরোধ গ্রহণ বা প্রত্যাখ্যান করতে status = PENDING_APPROVAL-এর জন্য ফিল্টার করুন।
লিঙ্ক করার অনুরোধ গ্রহণ বা প্রত্যাখ্যান করা DataLink-এর স্ট্যাটাস আপডেট করতে DataLinkService.UpdateDataLink পদ্ধতি ব্যবহার করুন যাতে অনুরোধ গ্রহণ করতে ENABLED অথবা বাতিল করতে REJECTED করা যায়।

লিঙ্কের বিবরণ ফিরিয়ে আনুন

data_link রিসোর্স কোয়েরি করতে আপনি GoogleAdsService.Search বা GoogleAdsService.SearchStream ব্যবহার করতে পারবেন। নিম্নলিখিত কোয়েরি YouTube ভিডিও লিঙ্কের বিবরণ ফিরিয়ে আনে, যার মধ্যে YouTube ভিডিও আইডি ও চ্যানেল আইডি অন্তর্ভুক্ত:

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 ভিডিও আইডি সঠিক না হওয়ায় ভিডিও লিঙ্ক তৈরি করা যায়নি।
DataLinkError.INVALID_STATUS অনুরোধ করা অপারেশনের জন্য ডেটা লিঙ্কের বর্তমান স্ট্যাটাস ভুল হলে এটি থ্রো করা হয়।
DataLinkError.INVALID_UPDATE_STATUS আপডেট করার সময় কাজ করে না এমন স্ট্যাটাস ট্রানজিশন করার চেষ্টা করলে (যেমন, সরাসরি REVOKED থেকে ENABLED-এ যাওয়া) এই সমস্যা হয়।
MutateError.RESOURCE_ALREADY_EXISTS ভিডিওর জন্য ডেটা লিঙ্ক আগে থেকেই থাকলে এটি থ্রো করা হয়।
পূর্ববর্তী
প্রোডাক্ট অ্যাকাউন্ট লিঙ্ক করা
পরবর্তী
স্ট্যাটাস পরিবর্তন করুন