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 ব্র্যান্ড চ্যানেলের আইডি প্রদান করা যায় এবং ক্রিয়েটররা আপনার ব্র্যান্ড সম্পর্কে বুঝতে পারেন। status DataLink-এর সেট করা উচিত নয়; API কল সফলভাবে সম্পূর্ণ হলে Google Ads API সার্ভার এটি REQUESTED-এ সেট করবে।
অনুরোধের স্ট্যাটাস চেক করুন data_link রিসোর্স সম্পর্কে কোয়েরি করতে GoogleAdsService.SearchStream বা GoogleAdsService.Search ব্যবহার করুন এবং এর status চেক করুন।
অনুরোধ প্রত্যাহার করা DataLink-এর status REQUESTED থেকে REVOKED-এ পরিবর্তন করে লিঙ্ক করার অনুরোধ প্রত্যাহার করতে DataLinkService.UpdateDataLink পদ্ধতি ব্যবহার করুন।
লিঙ্ক সরানো লিঙ্ক করা ভিডিও সরাতে DataLinkService.RemoveDataLink ব্যবহার করুন।
পরিস্থিতি ২ আমন্ত্রণ ফিরিয়ে আনা data_link রিসোর্স কোয়েরি করতে GoogleAdsService.Search বা GoogleAdsService.SearchStream ব্যবহার করুন। লিঙ্ক করার অনুরোধ গ্রহণ বা প্রত্যাখ্যান করতে status = PENDING_APPROVAL-এর জন্য ফিল্টার করুন।
লিঙ্ক করার অনুরোধ গ্রহণ বা প্রত্যাখ্যান করা অনুরোধ ENABLED গ্রহণ করতে বা REJECTED বাতিল করতে DataLink-এর স্ট্যাটাস আপডেট করতে DataLinkService.UpdateDataLink পদ্ধতি ব্যবহার করুন।

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

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 ভিডিওর জন্য ডেটা লিঙ্ক আগে থেকেই থাকলে এটি থ্রো করা হয়।
পূর্ববর্তী
প্রোডাক্ট অ্যাকাউন্ট লিঙ্ক করা
পরবর্তী
স্ট্যাটাস পরিবর্তন করুন