Channels: update

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

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

কোটা প্রভাব: এই পদ্ধতিতে একটি কলের কোটা খরচ 50 ইউনিট।

সাধারণ ব্যবহারের ক্ষেত্রে

অনুরোধ

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 বিষয়বস্তুর মালিকের সাথে লিঙ্ক করতে হবে।

শরীরের অনুরোধ

অনুরোধের অংশে একটি 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 ডেটা API - ত্রুটিগুলি দেখুন।

ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা
badRequest (400) brandingValidationError brandingSettings অবজেক্টের একটি মান যাচাইকরণ ব্যর্থ হয়েছে৷ চ্যানেলের জন্য বিদ্যমান সেটিংস পুনরুদ্ধার করতে channels.list পদ্ধতি ব্যবহার করুন, এবং channels রিসোর্স ডকুমেন্টেশনে নির্দেশিকা অনুসরণ করে সম্পত্তির মান আপডেট করুন।
badRequest (400) channelTitleUpdateForbidden একটি চ্যানেলের brandingSettings part আপডেট করার সময়, আপনাকে অবশ্যই চ্যানেলের বর্তমান শিরোনামে brandingSettings.channel.title সম্পত্তির মান সেট করতে হবে বা সম্পত্তিটি বাদ দিতে হবে। আপনি সম্পত্তির মান পরিবর্তন করলে API একটি ত্রুটি প্রদান করে।
badRequest (400) defaultLanguageNotSetError localizations আপডেট করতে defaultLanguage ভাষা সেট করা আবশ্যক।
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 ইনভিডিওপ্রমোশন অংশে অনুমোদিত প্রচারিত আইটেমের সংখ্যা ছাড়িয়ে গেছে।
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 উল্লেখিত সম্প্রতি আপলোড করা চ্যানেল আইডি পাওয়া যায়নি।
notFound (404) unknownVideoId একটি প্রচারিত আইটেম হিসাবে নির্দিষ্ট করা ভিডিও আইডি পাওয়া যাবে না৷
required (400) requiredItemIdType অনুরোধের মেটাডেটা অবশ্যই ইনভিডিওপ্রমোশন অংশে একটি আইটেমের প্রকার নির্দিষ্ট করতে হবে।
required (400) requiredItemId অনুরোধের মেটাডেটা অবশ্যই ইনভিডিওপ্রমোশন অংশে একটি আইটেম আইডি নির্দিষ্ট করতে হবে।
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 কল করতে APIs Explorer ব্যবহার করুন এবং API অনুরোধ এবং প্রতিক্রিয়া দেখুন।