Channels: update

API এখন আপনার চ্যানেল বা ভিডিও "বাচ্চাদের জন্য তৈরি" হিসেবে চিহ্নিত করার সুবিধা প্রদান করে। এছাড়াও, channel এবং video রিসোর্সে এখন এমন একটি প্রপার্টি আছে যা সেই চ্যানেল বা ভিডিওর "বাচ্চাদের জন্য তৈরি করা" স্ট্যাটাস শনাক্ত করে। এছাড়াও, ১০ জানুয়ারি ২০২০-তে YouTube API পরিষেবার শর্তাবলী এবং ডেভেলপার নীতি আপডেট করা হয়েছে। আরও তথ্যের জন্য, YouTube Data API পরিষেবা এবং YouTube API পরিষেবার শর্তাবলীর সংশোধনের ইতিহাস দেখুন।

চ্যানেলের মেটাডেটা আপডেট করে। মনে রাখবেন যে এই পদ্ধতিটি শুধুমাত্র channel রিসোর্সের brandingSettings, invideoPromotion এবং localizations অবজেক্ট এবং তাদের চাইল্ড প্রপার্টিতে আপডেট সমর্থন করে।

কোটার উপর প্রভাব: এই পদ্ধতিতে কল করলে ৫০ ইউনিট কোটা খরচ হয়।

সাধারণ ব্যবহারিক প্রয়োগ

অনুরোধ করুন

HTTP অনুরোধ

PUT https://www.googleapis.com/youtube/v3/channels

অনুমোদন

এই অনুরোধের জন্য নিম্নলিখিত স্কোপগুলির মধ্যে অন্তত একটির সাথে অনুমোদনের প্রয়োজন। যাচাইকরণ ও অনুমোদন সম্পর্কে আরও জানতে, OAuth 2.0 অনুমোদন প্রয়োগ করা দেখুন।

সুযোগ
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

প্যারামিটারগুলি

এই কোয়েরিতে যেসব প্যারামিটার কাজ করে তা নিম্নলিখিত সারণীতে দেওয়া হল। তালিকাবদ্ধ সব প্যারামিটার হল কোয়েরি প্যারামিটার।

প্যারামিটারগুলি
প্রয়োজনীয় প্যারামিটার
part string
এই অপারেশনে part প্যারামিটার দুটি উদ্দেশ্যে কাজ করে। এটি রাইট অপারেশন সেট করবে এমন প্রপার্টি এবং API রেসপন্সে অন্তর্ভুক্ত থাকবে এমন প্রপার্টি শনাক্ত করে।

API শুধুমাত্র প্যারামিটারের ভ্যালু brandingSettings, invideoPromotion অথবা localizations হিসেবে সেট করার অনুমতি দেয়। (আপনি একটি অনুরোধের মাধ্যমে শুধুমাত্র সেইসব অংশের মধ্যে যেকোনও একটি আপডেট করতে পারবেন।)

মনে রাখবেন, প্যারামিটারের মান যে অংশকে নির্দিষ্ট করে, সেই অংশে থাকা পরিবর্তনযোগ্য সমস্ত প্রপার্টির জন্য এই পদ্ধতিটি আগে থেকে থাকা মানকে ওভাররাইড করে।
ঐচ্ছিক প্যারামিটার
onBehalfOfContentOwner string
এই প্যারামিটার শুধুমাত্র যথাযথভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে।

onBehalfOfContentOwner প্যারামিটার থেকে বোঝা যায় যে, প্যারামিটার ভ্যালুতে উল্লেখ করা কন্টেন্টের মালিকের হয়েই যাচাই করা ব্যবহারকারী কাজ করছেন। এই প্যারামিটারটি YouTube কন্টেন্ট পার্টনারদের জন্য তৈরি করা হয়েছে যারা একাধিক YouTube চ্যানেলের মালিকানা ও ম্যানেজমেন্ট করেন। এটি কন্টেন্টের মালিকদের একবার যাচাইকরণ করার এবং প্রতিটি চ্যানেলের জন্য আলাদাভাবে যাচাইকরণ সংক্রান্ত ক্রেডেনশিয়াল প্রদান না করেই তাদের সমস্ত ভিডিও এবং চ্যানেল ডেটা অ্যাক্সেস করার অনুমতি দেয়। ব্যবহারকারী যে আসল CMS অ্যাকাউন্ট দিয়ে যাচাই করেন, সেটি নির্দিষ্ট YouTube কন্টেন্টের মালিকের সাথে লিঙ্ক করা থাকতে হবে।

ম্যানেজ করা চ্যানেলে কাজ করা CMS কন্টেন্টের মালিক ব্যবহারকারীর ক্রেডেনশিয়াল দিয়ে অনুরোধ যাচাই করা হলে, এই প্যারামিটার অবশ্যই প্রদান করতে হবে। বাদ দেওয়া হলে, অনুরোধটি যাচাই করা ব্যবহারকারীর সরাসরি প্রসঙ্গে কার্যকর হয় এবং HTTP 403 নিষিদ্ধ সমস্যা দেখায়।

অনুরোধের বডি

অনুরোধের বডিতে channel রিসোর্স প্রদান করুন। সেই রিসোর্সের জন্য:

  • এইসব প্রপার্টির জন্য আপনাকে অবশ্যই একটি মান উল্লেখ করতে হবে:

    • id

  • আপনি এইসব প্রপার্টির জন্য ভ্যালু সেট করতে পারবেন:

    • brandingSettings.channel.country
    • brandingSettings.channel.description
    • brandingSettings.channel.defaultLanguage
    • brandingSettings.channel.keywords
    • brandingSettings.channel.trackingAnalyticsAccountId
    • brandingSettings.channel.unsubscribedTrailer
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description
    • status.selfDeclaredMadeForKids

    আপনি যদি কোনও আপডেটের অনুরোধ জমা দেন এবং আপনার অনুরোধে আগে থেকেই ভ্যালু আছে এমন কোনও প্রপার্টির ভ্যালু উল্লেখ না করেন, তাহলে প্রপার্টির বর্তমান ভ্যালু মুছে যাবে।

রেসপন্স

সফল হলে, এই পদ্ধতিটি রেসপন্স বডিতে একটি channel রিসোর্স রিটার্ন করে।

সমস্যা

এই পদ্ধতিতে কল করার উত্তরে API যেসব সমস্যার মেসেজ পাঠাতে পারে, তা নিম্নলিখিত টেবিলে শনাক্ত করা হয়েছে। আরও জানতে, YouTube Data API - সমস্যা দেখুন।

সমস্যার ধরন সমস্যার বিবরণ বিবরণ
badRequest (400) brandingValidationError brandingSettings অবজেক্টের একটি ভ্যালু যাচাই করা যায়নি। চ্যানেলের আগে থেকে থাকা সেটিংস রিট্রিভ করতে channels.list পদ্ধতি ব্যবহার করুন এবং channels রিসোর্স ডকুমেন্টেশনে দেওয়া নির্দেশিকা অনুযায়ী প্রপার্টির ভ্যালু আপডেট করুন।
badRequest (400) channelTitleUpdateForbidden কোনও চ্যানেলের brandingSettings part আপডেট করার সময়, আপনাকে অবশ্যই brandingSettings.channel.title প্রপার্টির ভ্যালু চ্যানেলের বর্তমান নাম হিসেবে সেট করতে হবে অথবা প্রপার্টিটি বাদ দিতে হবে। আপনি প্রপার্টির ভ্যালু পরিবর্তন করলে API একটি সমস্যা দেখায়।
badRequest (400) defaultLanguageNotSetError defaultLanguage-কে localizations আপডেট করার জন্য সেট করতে হবে।
badRequest (400) invalidBrandingOption আপনার উল্লেখ করা ব্র্যান্ডিং সেটিংসের মধ্যে একটি উপলভ্য নেই। সঠিক ভ্যালু পেতে channels.list পদ্ধতি ব্যবহার করুন এবং channels রিসোর্স ডকুমেন্টেশনে দেওয়া নির্দেশিকা মেনে সেগুলি আপডেট করতে ভুলবেন না।
badRequest (400) invalidCustomMessage অনুরোধের মেটাডেটা একটি ভুল কাস্টম মেসেজ নির্দিষ্ট করে। অনুরোধ পাঠানো রিসোর্সে invideoPromotion.items[].customMessage প্রপার্টির ভ্যালু চেক করুন।
badRequest (400) invalidDuration অনুরোধের মেটাডেটা invideoPromotion অংশে একটি ভুল সময়সীমা উল্লেখ করে।
badRequest (400) invalidDuration ভিডিও প্লেয়ারে কীভাবে প্রচার করা আইটেমটি পজিশন করা হয় তা নির্ধারণ করার জন্য অনুরোধের মেটাডেটা একটি ভুল পজিশন টাইপ নির্দিষ্ট করে। অনুরোধ পাঠানো রিসোর্সে invideoPromotion.position.type প্রপার্টির ভ্যালু চেক করুন।
badRequest (400) invalidRecentlyUploadedBy অনুরোধের মেটাডেটায় ভুল চ্যানেল আইডি উল্লেখ করা হয়েছে। অনুরোধ পাঠানো রিসোর্সে invideoPromotion.items[].id.recentlyUploadedBy প্রপার্টির ভ্যালু চেক করুন।
badRequest (400) invalidTimingOffset অনুরোধের মেটাডেটা, invideoPromotion অংশে ভুল টাইমিং অফসেট নির্দিষ্ট করে।
badRequest (400) invalidTimingOffset ভিডিও প্লেয়ারে প্রোমোট করা আইটেম কখন দেখানো উচিত তা নির্ধারণ করার জন্য অনুরোধের মেটাডেটা একটি ভুল টাইমিং অফসেট নির্দিষ্ট করে। অনুরোধ পাঠানো রিসোর্সে invideoPromotion.timing.offsetMs প্রপার্টির ভ্যালু চেক করুন।
badRequest (400) invalidTimingType ভিডিও প্লেয়ারে প্রোমোট করা আইটেম কখন দেখানো উচিত তা নির্ধারণ করার জন্য অনুরোধের মেটাডেটা একটি ভুল টাইমিং পদ্ধতি নির্দিষ্ট করে। অনুরোধ পাঠানো রিসোর্সে invideoPromotion.timing.type প্রপার্টির ভ্যালু চেক করুন।
badRequest (400) localizationValidationError লোকালাইজেশন অবজেক্টের একটি ভ্যালু যাচাই করা যায়নি। সঠিক ভ্যালু পেতে channels.list পদ্ধতি ব্যবহার করুন এবং চ্যানেল রিসোর্স ডকুমেন্টেশনে দেওয়া নির্দেশিকা মেনে সেগুলি আপডেট করতে ভুলবেন না।
badRequest (400) tooManyPromotedItems invideoPromotion অংশে অনুমোদিত প্রোমোট করা আইটেমের সংখ্যা ছাড়িয়ে গেছে।
forbidden (403) channelForbidden id প্যারামিটারে উল্লেখ করা চ্যানেল অনুরোধটি সমর্থন করে না বা অনুরোধটি সঠিকভাবে অনুমোদিত নয়।
forbidden (403) promotedVideoNotAllowed API অনুরোধ যে চ্যানেল আপডেট করার চেষ্টা করছে সেটি খুঁজে পাওয়া যায়নি। চ্যানেল আইডি সঠিক কিনা তা নিশ্চিত করতে, অনুরোধ পাঠানো channel রিসোর্সে id প্রপার্টির ভ্যালু চেক করুন।
forbidden (403) websiteLinkNotAllowed নির্দিষ্ট করা ওয়েবসাইট URL অনুমোদিত নয়।
notFound (404) channelNotFound id প্যারামিটারে উল্লেখ করা চ্যানেল খুঁজে পাওয়া যাচ্ছে না।
notFound (404) channelNotFound id প্যারামিটার দ্বারা নির্দিষ্ট করা চ্যানেলটি খুঁজে পাওয়া যাচ্ছে না বা এতে ব্র্যান্ডিং বিকল্প নেই।
notFound (404) unknownChannelId নির্দিষ্ট করা চ্যানেল আইডি খুঁজে পাওয়া যায়নি।
notFound (404) unknownChannelId নির্দিষ্ট recentlyUploadedBy চ্যানেল আইডি খুঁজে পাওয়া যায়নি।
notFound (404) unknownVideoId প্রোমোটেড আইটেম হিসেবে উল্লেখ করা ভিডিও আইডি খুঁজে পাওয়া যায়নি।
required (400) requiredItemIdType অনুরোধের মেটাডেটায় invideoPromotion অংশে আইটেমের ধরন উল্লেখ করতে হবে।
required (400) requiredItemId অনুরোধের মেটাডেটায় invideoPromotion অংশে অবশ্যই একটি আইটেম আইডি উল্লেখ করতে হবে।
required (400) requiredTimingOffset অনুরোধের মেটাডেটায় ডিফল্ট টাইমিং অফসেট উল্লেখ করতে হবে যাতে YouTube বুঝতে পারে যে প্রোমোট করা আইটেমটি কখন দেখাতে হবে। অনুরোধের মাধ্যমে পাঠানো রিসোর্সে invideoPromotion.defaultTiming.offsetMs প্রপার্টির ভ্যালু সেট করুন।
required (400) requiredTimingOffset অনুরোধের মেটাডেটায় অবশ্যই টাইমিং অফসেট উল্লেখ করতে হবে যাতে YouTube নির্ধারণ করতে পারে যে প্রোমোট করা আইটেমটি কখন দেখাতে হবে। অনুরোধ যে রিসোর্স পাঠায় তাতে invideoPromotion.timing.offsetMs প্রপার্টির ভ্যালু সেট করুন।
required (400) requiredTimingType অনুরোধের মেটাডেটায় অবশ্যই টাইমিং পদ্ধতি উল্লেখ করতে হবে যাতে YouTube নির্ধারণ করতে পারে যে প্রোমোট করা আইটেমটি কখন দেখাতে হবে। অনুরোধ যে রিসোর্স পাঠায় তাতে invideoPromotion.defaultTiming.type প্রপার্টির ভ্যালু সেট করুন।
required (400) requiredTimingType অনুরোধের মেটাডেটায় অবশ্যই একটি টাইমিং পদ্ধতি উল্লেখ করতে হবে যাতে YouTube নির্ধারণ করতে পারে যে কখন প্রচার করা আইটেমটি দেখাতে হবে। অনুরোধ যে রিসোর্স পাঠায় তাতে invideoPromotion.timing.type প্রপার্টির ভ্যালু সেট করুন।
required (400) requiredTiming অনুরোধের মেটাডেটায় invideoPromotion অংশের প্রতিটি আইটেমের জন্য সময় উল্লেখ করতে হবে।
required (400) requiredVideoId প্রোমোশন করা আইটেম শনাক্ত করার জন্য অনুরোধের মেটাডেটায় অবশ্যই একটি ভিডিও আইডি উল্লেখ করতে হবে।
required (400) requiredWebsiteUrl অনুরোধের মেটাডেটায় invideoPromotion অংশে অবশ্যই একটি ওয়েবসাইট URL উল্লেখ করতে হবে। অনুরোধের মাধ্যমে পাঠানো রিসোর্সে invideoPromotion.items[].id.websiteUrl প্রপার্টির ভ্যালু সেট করুন।

এটি ব্যবহার করে দেখুন!

এই API কল করতে এবং API অনুরোধ ও উত্তর দেখতে APIs Explorer ব্যবহার করুন।