রচনা সম্পদ ব্যবস্থাপনা

দ্রষ্টব্য: YouTube বিষয়বস্তু আইডি API YouTube সামগ্রী অংশীদারদের দ্বারা ব্যবহারের উদ্দেশ্যে এবং সমস্ত বিকাশকারী বা সমস্ত YouTube ব্যবহারকারীদের কাছে অ্যাক্সেসযোগ্য নয়৷ আপনি যদি YouTube Content ID API-কে Google API কনসোলে তালিকাভুক্ত পরিষেবাগুলির মধ্যে একটি হিসাবে দেখতে না পান তবে YouTube পার্টনার প্রোগ্রাম সম্পর্কে আরও জানতে YouTube সহায়তা কেন্দ্র দেখুন৷

দ্রষ্টব্য: এই নির্দেশিকাটির তথ্য বিশেষভাবে রচনা সম্পদের ক্ষেত্রে প্রযোজ্য।

YouTube-এর অধিকার ব্যবস্থাপনা সিস্টেমে, একটি সম্পদ মেধা সম্পত্তির একটি অংশকে প্রতিনিধিত্ব করে। YouTube বিভিন্ন ধরনের সম্পদকে স্বীকৃতি দেয়, যেমন সিনেমা, মিউজিক ভিডিও, সাউন্ড রেকর্ডিং এবং কম্পোজিশন।

কম্পোজিশন মালিকানা এবং অধিকারের জটিল প্রকৃতির কারণে, YouTube কম্পোজিশন সম্পদের জন্য একটি দ্বি-স্তর বিশিষ্ট সম্পদ মডেল ব্যবহার করে। মডেলটি নিম্নলিখিত জন্য অ্যাকাউন্টের জন্য ডিজাইন করা হয়েছে:

  • প্রতিটি শব্দ রেকর্ডিং একটি রচনা সঙ্গে যুক্ত করা হয়.
  • বিষয়বস্তুর মালিকদের প্রায়ই একই গান বা বিভিন্ন সাউন্ড রেকর্ডিংয়ের জন্য প্রকাশনা অধিকারের মালিকানা প্রয়োগ করতে হয়।

এই দস্তাবেজটি YouTube-এর রচনা সম্পদ মডেলের একটি ওভারভিউ প্রদান করে৷ এটি YouTube Content ID API পদ্ধতিতে কীভাবে দুই ধরনের রচনা সম্পদ ব্যবহার করা হয় তাও ব্যাখ্যা করে।

কম্পোজিশন অ্যাসেট মডেল বোঝা

YouTube-এর সম্পদ মডেল কম্পোজিশন সম্পদের দুটি ভিন্ন উপস্থাপনাকে সংজ্ঞায়িত করে:

  • একটি রচনা শেয়ার সেই তথ্য উপস্থাপন করে যা একটি নির্দিষ্ট প্রকাশক একটি রচনা সম্পদ সম্পর্কে প্রদান করে। এইভাবে, একটি রচনা শেয়ার শুধুমাত্র মেটাডেটা, মালিকানা এবং নীতি ডেটা সনাক্ত করে যা একক প্রকাশক রচনার জন্য প্রদান করে।

    একটি কম্পোজিশন শেয়ার অনেক সাউন্ড রেকর্ডিংয়ের সাথে যুক্ত হতে পারে।

  • একটি কম্পোজিশন ভিউ কম্পোজিশন সম্পদের প্রতিনিধিত্ব করে যা একটি সাউন্ড রেকর্ডিং এ এমবেড করা থাকে। প্রতিটি সাউন্ড রেকর্ডিং ম্যাপ ঠিক একটি কম্পোজিশন ভিউতে, এবং কম্পোজিশন ভিউ তথ্যের ক্যানোনিকাল সেট উপস্থাপন করে যা YouTube একটি রচনা সম্পর্কে প্রদর্শন করে। কম্পোজিশন ভিউ এর মেটাডেটা, মালিকানা ডেটা এবং নীতি নির্ধারণ করা হয় সংশ্লিষ্ট সমস্ত কম্পোজিশন শেয়ার সম্পদ থেকে ডেটা ব্যবহার করে।

    একটি কম্পোজিশন ভিউ শূন্য বা তার বেশি কম্পোজিশন শেয়ার ম্যাপ করতে পারে। যাইহোক, একটি কম্পোজিশন ভিউ শুধুমাত্র একাধিক কম্পোজিশন শেয়ারে ম্যাপ করে যখন একটি কম্পোজিশনের একাধিক মালিক থাকে।

    মনে রাখবেন যে API ব্যবহার করে একজন একক বিষয়বস্তুর মালিকের পক্ষে একটি রচনার একাধিক মালিকদের প্রতিনিধিত্ব করা সম্ভব এবং তাই, সেই রচনাটির একাধিক শেয়ারের মালিক৷ উদাহরণস্বরূপ, ডিজিটাল অধিকারের একটি সমষ্টিকারী বিভিন্ন অঞ্চলের বিভিন্ন পক্ষের কাছ থেকে একই রচনার অধিকার পেতে পারে। সমষ্টিকারীর সেই অধিকারগুলির প্রতিনিধিত্বকারী পৃথক সত্তা থাকবে, যা YouTube-এর মডেলে বিভিন্ন রচনা শেয়ারের মানচিত্র করবে৷ বিভিন্ন কম্পোজিশন শেয়ার এখনও একই কম্পোজিশন ভিউয়ের সাথে লিঙ্ক করা যেতে পারে।

নিম্নলিখিত চিত্রটি এই মডেলটিকে চিত্রিত করে। চিত্রে:

  • চেনাশোনা শব্দ রেকর্ডিং হয়.
  • স্কোয়ার হল কম্পোজিশন ভিউ।
  • ত্রিভুজ হল রচনা শেয়ার। প্রতিটি ত্রিভুজ রঙ একটি ভিন্ন বিষয়বস্তুর মালিক প্রতিনিধিত্ব করে। স্কোয়ারের ভিতরের ছোট ত্রিভুজগুলি দেখায় যে কোন কম্পোজিশন সম্পর্কে YouTube প্রদর্শন করে এমন তথ্যের ক্যানোনিকাল সেট তৈরি করতে কোন ডেটা একত্রিত করা হয়েছে। YouTube একটি রচনার মালিকানা এবং নীতি গণনা করতে সেই ডেটা ব্যবহার করে৷

সাউন্ড রেকর্ডিং, কম্পোজিশন ভিউ এবং কম্পোজিশন শেয়ারের মধ্যে সম্পর্ক দেখানো ডায়াগ্রাম।

দুই ধরনের সম্পদ আইডি

YouTube কম্পোজিশন শেয়ার এবং কম্পোজিশন ভিউতে আইডি বরাদ্দ করে এবং উভয়কেই সম্পদ আইডি হিসেবে বিবেচনা করা হয়। যাইহোক, তারা API এ বিনিময়যোগ্য নয়। সেই কথা মাথায় রেখে, এই নথির বাকি অংশটি যথাক্রমে কম্পোজিশন শেয়ার এবং কম্পোজিশন ভিউতে বরাদ্দ করা আইডিগুলিকে উল্লেখ করতে shareId এবং viewId শব্দগুলি ব্যবহার করে৷

সাধারণভাবে, যখন আপনি কোনো সম্পদ সম্পর্কে আপনার দেওয়া তথ্য পুনরুদ্ধার বা আপডেট করছেন, আপনি একটি shareId ব্যবহার করবেন। আপনি যদি কোনো সম্পদ সম্পর্কে YouTube প্রদর্শন করে এমন তথ্যের ক্যানোনিকাল সেট পুনরুদ্ধার করেন, আপনি একটি viewId ব্যবহার করবেন।

আপনি যদি পূর্ববর্তী বিভাগে চিত্রটিতে ফিরে তাকান, আপনি দেখতে পাবেন যে সাউন্ড রেকর্ডিং এবং কম্পোজিশন ভিউ সংখ্যা দিয়ে চিহ্নিত করা হয়েছে (SR 1 , CV 1 , ইত্যাদি)। সংখ্যাগুলি সাউন্ড রেকর্ডিং এবং কম্পোজিশন ভিউয়ের মধ্যে 1:1 সম্পর্ক প্রতিফলিত করে। সুতরাং, আপনি যদি একটি নির্দিষ্ট সাউন্ড রেকর্ডিংয়ে রচনা সম্পর্কে তথ্যের ক্যানোনিকাল সেট পুনরুদ্ধার করতে চান তবে আপনি সেই রচনাটির জন্য viewId ব্যবহার করবেন।

অন্যদিকে, কম্পোজিশন শেয়ারগুলি অক্ষর দিয়ে চিহ্নিত করা হয় (CS b , ইত্যাদি)। চিঠিগুলি বিভিন্ন বিষয়বস্তুর মালিকদের প্রতিনিধিত্ব করে। সুতরাং, আপনি যদি সবুজ সামগ্রীর মালিক হন, এবং আপনি মেটাডেটা বা মালিকানা ডেটা পুনরুদ্ধার করতে চান যা আপনি একটি রচনা সম্পদের জন্য প্রদান করেছিলেন, আপনি সেই তথ্য পুনরুদ্ধার করতে shareId ব্যবহার করবেন৷

API পদ্ধতিতে সম্পদ আইডি ব্যবহার করা

এই নথির অবশিষ্টাংশ ব্যাখ্যা করে যে কীভাবে পৃথক API পদ্ধতিগুলি shareIds এবং viewIds পরিচালনা করে যখন সেই আইডিগুলি প্যারামিটার বা সম্পত্তির মান হিসাবে ব্যবহার করা হয়। যেহেতু API পদ্ধতিগুলি বর্ণানুক্রমিকভাবে তালিকাভুক্ত করা হয়েছে, তাই প্রথমে একটি রচনা সম্পদ তৈরি করা এবং এটিকে একটি সাউন্ড রেকর্ডিংয়ের সাথে লিঙ্ক করার সাথে যুক্ত সাধারণ পদক্ষেপগুলির মধ্য দিয়ে হাঁটা কার্যকর হতে পারে।

  1. একটি রচনা সম্পদ তৈরি করতে assets.insert পদ্ধতিতে কল করুন। এপিআই প্রতিক্রিয়া হল একটি asset সম্পদ যেখানে id সম্পত্তি একটি shareId ।

  2. কম্পোজিশন শেয়ারের জন্য মালিকানা ডেটা সেট করতে ownership.update পদ্ধতিতে কল করুন। পদ্ধতির assetId প্যারামিটারটি ধাপ 1 এ প্রাপ্ত shareId সেট করুন।

  3. কম্পোজিশন শেয়ারের জন্য নীতি ডেটা সেট করতে assetMatchPolicy.update পদ্ধতিতে কল করুন। নীতিটি দাবি করা ভিডিওগুলিতে প্রয়োগ করা হয় যাতে রচনাটি রয়েছে৷ পদ্ধতির assetId প্যারামিটারটি ধাপ 1 এ প্রাপ্ত shareId সেট করুন।

  4. কম্পোজিশন রয়েছে এমন সাউন্ড রেকর্ডিং সনাক্ত করতে assetRelationships.insert পদ্ধতিতে কল করুন। আপনি যে assetRelationship সংস্থানটি ঢোকাচ্ছেন তাতে, সাউন্ড রেকর্ডিংয়ের সম্পদ আইডিতে parentAssetId প্রপার্টি সেট করুন। ধাপ 1 এ প্রাপ্ত shareId childAssetId সম্পত্তি সেট করুন।

  5. আপনি যদি shareIds এ viewIds এর ম্যাপিং সঞ্চয় করেন, তাহলে আপনি assetRelationships.list পদ্ধতিতে কল করে এবং সাউন্ড রেকর্ডিংয়ের সম্পদ আইডিতে assetId প্যারামিটার সেট করে viewId পুনরুদ্ধার করতে পারেন। ফলাফল সেটে একটি সম্পর্ক সাউন্ড রেকর্ডিংয়ের সম্পদ আইডিটিকে parentAssetId হিসাবে চিহ্নিত করবে। সেই সম্পর্কের ক্ষেত্রে, childAssetId সেই viewId সনাক্ত করে যা ধাপ 1 এ প্রাপ্ত shareId -তে মানচিত্র করে।

সম্পদ তৈরি হওয়ার পরে, আপনি এটি সম্পর্কে তথ্য পুনরুদ্ধার করতে, এটি আপডেট করতে বা এটি মুছে ফেলার জন্য এই নথির বাকি অংশে আলোচিত যে কোনও পদ্ধতি ব্যবহার করতে পারেন৷

assets.get/assets.list

assets.get এবং assets.list পদ্ধতিগুলি একটি সম্পদ বা সম্পদের তালিকা সম্পর্কে তথ্য পুনরুদ্ধার করে। উভয় পদ্ধতি একই সেট অনুরোধ পরামিতি সমর্থন করে।

এই প্যারামিটারগুলির মধ্যে তিনটি – fetchMatchPolicy , fetchMetadata , এবং fetchOwnership – effective এবং mine মানগুলি ব্যবহার করে নির্দেশ করে যে আপনি সম্পদ সম্পর্কে ক্যানোনিকাল ডেটার সেট পুনরুদ্ধার করতে চান বা আপনি সম্পদ সম্পর্কে যে ডেটা প্রদান করেছেন তা পুনরুদ্ধার করতে চান কিনা। এই মানগুলি YouTube-এর পুরানো কম্পোজিশন অ্যাসেট মডেলের একটি ভেস্টিজ, যা একটি কম্পোজিশন ভিউ এবং এর কম্পোজিশন শেয়ারকে একক সত্তা হিসাবে বিবেচনা করে।

মানগুলি এখনও দ্বি-স্তরযুক্ত মডেলে সমর্থিত, তবে, এবং API প্রতিক্রিয়ার বিষয়বস্তু প্যারামিটার মান এবং অনুরোধগুলি shareIds বা viewIds প্রদান করছে কিনা উভয়ের উপর নির্ভরশীল। মনে রাখবেন যে assets.get পদ্ধতি সম্পদ আইডি নির্দিষ্ট করতে assetId প্যারামিটার ব্যবহার করে, যখন assets.list পদ্ধতি id প্যারামিটার ব্যবহার করে।

নীচের তালিকাটি ব্যাখ্যা করে যে কীভাবে অনুরোধ প্যারামিটার মানগুলি এই দুটি পদ্ধতির জন্য API প্রতিক্রিয়াগুলির বিষয়বস্তুকে প্রভাবিত করে৷

  • fetchMatchPolicy
    • যদি সম্পদ আইডি ( id বা assetId প্যারামিটার) একটি shareId নির্দিষ্ট করে:
      • যদি fetchMatchPolicy প্যারামিটারটি mine হয়, তাহলে API প্রতিক্রিয়াতে এমন নীতি থাকে যা কন্টেন্ট মালিক কম্পোজিশন শেয়ারের জন্য সেট করা API অনুরোধ অনুমোদন করে।
      • fetchMatchPolicy প্যারামিটার effective হলে, API একটি 400 ত্রুটি প্রদান করে।
    • যদি সম্পদ আইডি একটি viewId নির্দিষ্ট করে:
      • যদি fetchMatchPolicy প্যারামিটারটি mine হয় , এবং অনুরোধ অনুমোদনকারী সামগ্রীর মালিক শুধুমাত্র একটি কম্পোজিশন শেয়ারের মালিক হন যা ভিউ আইডির সাথে লিঙ্ক করা হয়, তাহলে API সেই কম্পোজিশন শেয়ারের জন্য সেট করা মিল নীতি ফেরত দেয়।
      • যদি fetchMatchPolicy প্যারামিটারটি mine হয় , এবং অনুরোধ অনুমোদনকারী বিষয়বস্তুর মালিক ভিউ আইডির সাথে লিঙ্ক করা একাধিক কম্পোজিশন শেয়ারের মালিক হন, তাহলে API একটি 400 ত্রুটি প্রদান করে৷
      • fetchMatchPolicy প্যারামিটার effective হলে, API কম্পোজিশন ভিউয়ের জন্য ক্যানোনিকাল মিল নীতি প্রদান করে। সেই ম্যাচ নীতিটি viewId সাথে লিঙ্ক করা সমস্ত কম্পোজিশন শেয়ারের মিল নীতিগুলির জন্য অ্যাকাউন্ট করে, কোন বিষয়বস্তুর মালিকরা সেই শেয়ারগুলির মালিকানা নির্বিশেষে৷
  • fetchMetadata
    • যদি সম্পদ আইডি একটি shareId নির্দিষ্ট করে:
      • যদি fetchMetadata প্যারামিটারটি mine হয়, তাহলে API প্রতিক্রিয়াতে সম্পদের মেটাডেটা থাকে যা সামগ্রীর মালিক কম্পোজিশন শেয়ারের জন্য সেট করা API অনুরোধ অনুমোদন করে।
      • fetchMetadata প্যারামিটার effective হলে, API একটি 400 ত্রুটি প্রদান করে।
    • যদি সম্পদ আইডি একটি viewId নির্দিষ্ট করে:
      • যদি fetchMetadata প্যারামিটারটি mine হয় , এবং অনুরোধ অনুমোদনকারী বিষয়বস্তুর মালিক শুধুমাত্র একটি কম্পোজিশন শেয়ারের মালিক যেটি ভিউ আইডির সাথে লিঙ্ক করা আছে, তাহলে API সেই কম্পোজিশন শেয়ারের জন্য সেট করা মেটাডেটা ফেরত দেয়।
      • যদি fetchMetadata প্যারামিটারটি mine হয় , এবং অনুরোধ অনুমোদনকারী বিষয়বস্তুর মালিক ভিউ আইডির সাথে লিঙ্ক করা একাধিক কম্পোজিশন শেয়ারের মালিক হন, তাহলে API একটি 400 ত্রুটি প্রদান করে৷
      • যদি fetchMetadata প্যারামিটার effective হয়, তাহলে API কম্পোজিশন ভিউয়ের জন্য মেটাডেটার ক্যানোনিকাল সেট ফেরত দেয়। সেই মেটাডেটা viewId সাথে লিঙ্ক করা সমস্ত কম্পোজিশন শেয়ারের জন্য প্রদত্ত সম্পদ মেটাডেটার জন্য হিসাব করে, কোন বিষয়বস্তুর মালিকরা সেই শেয়ারগুলির মালিক হন না কেন।
  • fetchOwnership
    • যদি সম্পদ আইডি একটি shareId নির্দিষ্ট করে:
      • যদি fetchOwnership প্যারামিটারটি mine হয় , API প্রতিক্রিয়াতে মালিকানা ডেটা থাকে যা সামগ্রীর মালিক এপিআই অনুরোধ অনুমোদন করে কম্পোজিশন শেয়ারের জন্য সেট করে৷
      • fetchOwnership প্যারামিটার effective হলে, API একটি 400 ত্রুটি প্রদান করে।
    • যদি সম্পদ আইডি একটি viewId নির্দিষ্ট করে:
      • যদি fetchOwnership প্যারামিটারটি mine হয় , এবং অনুরোধ অনুমোদনকারী সামগ্রীর মালিক শুধুমাত্র একটি রচনা শেয়ারের মালিক হন যা ভিউ আইডির সাথে লিঙ্ক করা হয়, তাহলে API সেই কম্পোজিশন শেয়ারের জন্য সেট করা মালিকানা ডেটা ফেরত দেয়৷
      • যদি fetchOwnership প্যারামিটারটি mine হয় , এবং অনুরোধ অনুমোদনকারী সামগ্রীর মালিক ভিউ আইডির সাথে লিঙ্ক করা একাধিক কম্পোজিশন শেয়ারের মালিক হন, তাহলে API একটি 400 ত্রুটি প্রদান করে৷
      • fetchOwnership প্যারামিটার effective হলে, API কম্পোজিশন ভিউয়ের জন্য ক্যানোনিকাল মালিকানা ডেটা প্রদান করে। সেই ডেটা viewId সাথে লিঙ্ক করা সমস্ত কম্পোজিশন শেয়ারের মালিকানা ডেটার জন্য অ্যাকাউন্ট করে, কোন বিষয়বস্তুর মালিকরা সেই শেয়ারগুলির মালিক হন না কেন।
  • fetchOwnershipConflicts
    • যদি সম্পদ আইডি একটি shareId নির্দিষ্ট করে, তাহলে API একটি 400 ত্রুটির প্রতিক্রিয়া প্রদান করে।
    • যদি সম্পদ আইডি একটি viewId নির্দিষ্ট করে, তাহলে এপিআই কম্পোজিশন ভিউয়ের সাথে সম্পর্কিত মালিকানা বিরোধের একটি তালিকা প্রদান করে।

assets.insert

এই পদ্ধতিটি একটি asset সংস্থান তৈরি করে এবং YouTube সেই সংস্থানটিকে অনন্যভাবে সনাক্ত করার জন্য একটি আইডি বরাদ্দ করে৷ সেই আইডি, যা API প্রতিক্রিয়ায় id সম্পত্তির মান হিসাবে ফেরত দেওয়া হয়, একটি shareId ।

দ্রষ্টব্য: একটি অনুস্মারক হিসাবে, shareIds এবং viewIds শুধুমাত্র রচনা সম্পদের জন্য ব্যবহার করা হয়৷ অন্যান্য ধরনের সম্পদ সম্পদ ডেটা পরিচালনার জন্য একটি দ্বি-স্তরযুক্ত মডেল ব্যবহার করে না।

assets.update এবং assets.patch

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

  • যদি assetId প্যারামিটার এবং id বৈশিষ্ট্য একটি shareId নির্দিষ্ট করে, তাহলে API অনুরোধ নির্দিষ্ট কম্পোজিশন শেয়ার আপডেট করে।
  • যদি assetId প্যারামিটার এবং id বৈশিষ্ট্য একটি viewId নির্দিষ্ট করে, এবং অনুরোধ অনুমোদনকারী সামগ্রীর মালিক শুধুমাত্র একটি কম্পোজিশন শেয়ারের মালিক হন যা সেই viewId এর সাথে লিঙ্ক করা হয়, তাহলে API অনুরোধ সেই কম্পোজিশন শেয়ার আপডেট করে।
  • যদি assetId প্যারামিটার এবং id বৈশিষ্ট্য একটি viewId নির্দিষ্ট করে, এবং অনুরোধ অনুমোদনকারী সামগ্রীর মালিক সেই viewId সাথে লিঙ্ক করা একাধিক কম্পোজিশন শেয়ারের মালিক হন, তাহলে API অনুরোধটি একটি 400 ত্রুটি প্রদান করে৷

assetMatchPolicy.get

এই পদ্ধতিটি একটি নির্দিষ্ট সম্পদের জন্য সংজ্ঞায়িত ম্যাচ নীতি প্রদান করে। অনুরোধের assetId প্যারামিটার সম্পদটিকে চিহ্নিত করে।

  • যদি assetId প্যারামিটার একটি shareId নির্দিষ্ট করে, তাহলে API প্রতিক্রিয়াতে সম্পদের মেটাডেটা থাকে যা কন্টেন্ট মালিক এপিআই অনুরোধ অনুমোদন করে কম্পোজিশন শেয়ারের জন্য সেট করে।
  • যদি assetId প্যারামিটার একটি viewId নির্দিষ্ট করে, তাহলে এপিআই কম্পোজিশন ভিউয়ের জন্য মেটাডেটার ক্যানোনিকাল সেট প্রদান করে। সেই মেটাডেটা viewId সাথে লিঙ্ক করা সমস্ত কম্পোজিশন শেয়ারের জন্য প্রদত্ত সম্পদ মেটাডেটার জন্য হিসাব করে, কোন বিষয়বস্তুর মালিকরা সেই শেয়ারগুলির মালিক হন না কেন।

assetMatchPolicy.update এবং assetMatchPolicy.patch

এই পদ্ধতিগুলি একটি নির্দিষ্ট সম্পদের জন্য ম্যাচ নীতি আপডেট করে। অনুরোধের assetId প্যারামিটার সম্পদটিকে চিহ্নিত করে।

  • যদি assetId প্যারামিটার একটি shareId নির্দিষ্ট করে, তাহলে API অনুরোধ সেই কম্পোজিশন শেয়ারের জন্য মিল নীতি আপডেট করে।
  • যদি assetId প্যারামিটার একটি viewId নির্দিষ্ট করে, এবং অনুরোধ অনুমোদনকারী সামগ্রীর মালিক শুধুমাত্র একটি কম্পোজিশন শেয়ারের মালিক হন যা সেই viewId এর সাথে লিঙ্ক করা হয়, তাহলে API অনুরোধ সেই কম্পোজিশন শেয়ারের জন্য মিল নীতি আপডেট করে।
  • যদি assetId প্যারামিটার একটি viewId নির্দিষ্ট করে, এবং অনুরোধের অনুমোদনকারী সামগ্রীর মালিক সেই viewId সাথে লিঙ্ক করা একাধিক রচনা শেয়ারের মালিক হন, তাহলে API অনুরোধটি একটি 400 ত্রুটি প্রদান করে।

assetRelationships.list

এই পদ্ধতিটি একটি নির্দিষ্ট সম্পদের জন্য সম্পদ সম্পর্কের একটি তালিকা প্রদান করে। অনুরোধের assetId প্যারামিটার সম্পদটিকে চিহ্নিত করে।

  • যদি assetId প্যারামিটার একটি shareId নির্দিষ্ট করে, তাহলে API প্রতিক্রিয়াতে লিঙ্ক করা শব্দ রেকর্ডিং সম্পদের একটি তালিকা থাকে। তালিকায় একাধিক আইটেম থাকতে পারে। প্রতিটি assetRelationship রিসোর্সে, সাউন্ড রেকর্ডিংয়ের অ্যাসেট আইডি হল parentAssetId , এবং shareId হল childAssetId ৷
  • যদি assetId প্যারামিটার একটি viewId নির্দিষ্ট করে, API প্রতিক্রিয়া সেই viewId এর সাথে লিঙ্ক করা সাউন্ড রেকর্ডিং চিহ্নিত করে। প্রতিক্রিয়া সর্বাধিক একটি সম্পদ রয়েছে.
  • যদি assetId প্যারামিটার একটি শব্দ রেকর্ডিং সম্পদ সনাক্ত করে, API প্রতিক্রিয়া একাধিক সম্পর্ক ধারণ করতে পারে।
    • যদি সাউন্ড রেকর্ডিংয়ের সম্পদ আইডিটি ফেরত দেওয়া assetRelationship সম্পদের parentAssetId হয়, তাহলে childAssetId সেই সাউন্ড রেকর্ডিংয়ের সাথে লিঙ্ক করা কম্পোজিশন ভিউ ( viewId ) সনাক্ত করে। প্রতিটি সাউন্ড রেকর্ডিং ঠিক এই ধরনের একটি সম্পর্ক আছে.
    • যদি সাউন্ড রেকর্ডিং এর সম্পদ আইডি হয় childAssetId , তাহলে parentAssetId এমন একটি ভিডিও সনাক্ত করে যাতে সাউন্ড রেকর্ডিং রয়েছে, যেমন একটি মিউজিক ভিডিও বা আর্ট ট্র্যাক ভিডিও। প্রতিটি শব্দ রেকর্ডিং একাধিক এই ধরনের সম্পর্ক থাকতে পারে.

assetRelationships.insert

এই পদ্ধতি দুটি সম্পদের মধ্যে সম্পর্ক তৈরি করে। আপনি একটি সাউন্ড রেকর্ডিংয়ের সাথে লিঙ্কযুক্ত রচনাটির একটি শেয়ারের মালিক তা নির্দেশ করার জন্য এই পদ্ধতিটিকে কল করবেন।

রিকোয়েস্ট বডিতে assetRelationship রিসোর্সে, সাউন্ড রেকর্ডিংয়ের অ্যাসেট আইডিতে parentAssetId প্রপার্টি সেট করুন। childAssetId সম্পত্তি shareId সেট করুন।

assetSearch.list

এই পদ্ধতি সম্পদ মেটাডেটার উপর ভিত্তি করে সম্পদ অনুসন্ধান করে। API প্রতিক্রিয়াটিতে assetSearch সংস্থানগুলির একটি তালিকা রয়েছে, যেখানে প্রতিটি সংস্থানের id বৈশিষ্ট্য একটি সম্পদ আইডি সনাক্ত করে৷ id সম্পত্তির মান আসলে, একটি সম্পদ আইডি।

  • যদি assetSearch সংস্থান একটি রচনা শনাক্ত করে, তাহলে id সম্পত্তির মান একটি shareId হবে।

assetShares.list

এই পদ্ধতিটি কম্পোজিশন শেয়ারে কম্পোজিশন ভিউ এর ম্যাপিং প্রদান করে। অনুরোধের assetId প্যারামিটার একটি viewId বা একটি shareId নির্দিষ্ট করতে পারে।

  • যদি assetId প্যারামিটার একটি viewId নির্দিষ্ট করে, তাহলে API প্রতিক্রিয়াতে assetShare সম্পদের একটি তালিকা থাকে। প্রতিটি সংস্থান একটি কম্পোজিশন শেয়ারকে চিহ্নিত করে যা নির্দিষ্ট কম্পোজিশন ভিউয়ের সাথে লিঙ্ক করা হয় এবং অনুরোধটি অনুমোদনকারী বিষয়বস্তুর মালিকের মালিকানাধীন।

    API প্রতিক্রিয়াতে একাধিক assetShare সম্পদ থাকতে পারে। সাধারণ ব্যবহারের ক্ষেত্রে যেখানে একটি viewId একই সামগ্রীর মালিকের মালিকানাধীন একাধিক shareIds ম্যাপ করা হয় তা এই নথির কম্পোজিশন সম্পদ মডেল বিভাগে বর্ণনা করা হয়েছে।

  • যদি assetId প্যারামিটার একটি shareId নির্দিষ্ট করে, তাহলে API প্রতিক্রিয়াতে assetShare সম্পদের একটি তালিকা থাকে। প্রতিটি সংস্থান নির্দিষ্ট কম্পোজিশন শেয়ারের সাথে যুক্ত একটি রচনা দৃশ্যকে চিহ্নিত করে। প্রতিক্রিয়াটিতে প্রতিটি সাউন্ড রেকর্ডিংয়ের জন্য একটি সংস্থান থাকবে যার সাথে কম্পোজিশন শেয়ার লিঙ্ক করা হয়েছে। (প্রতিটি সাউন্ড রেকর্ডিং ঠিক একটি কম্পোজিশন ভিউয়ের সাথে লিঙ্ক করা হয়েছে।)

claimSearch.list

এই পদ্ধতিটি নির্দিষ্ট অনুসন্ধানের মানদণ্ডের সাথে মিলে যাওয়া দাবিগুলির একটি তালিকা প্রদান করে। পদ্ধতির assetId প্যারামিটার আপনাকে একটি নির্দিষ্ট সম্পদের সাথে সম্পর্কিত দাবিগুলি অনুসন্ধান করতে সক্ষম করে৷

  • যদি API অনুরোধ একটি shareId নির্দিষ্ট করে, API একটি 400 প্রতিক্রিয়া কোড প্রদান করে।

  • যদি এপিআই অনুরোধ একটি viewId নির্দিষ্ট করে, তাহলে এপিআই নির্দিষ্ট কম্পোজিশন ভিউয়ের সাথে যুক্ত দাবির একটি তালিকা ফেরত দেয়, যা ঠিক একটি সাউন্ড রেকর্ডিং অ্যাসেটে ম্যাপ করে।

metadataHistory.list

এই পদ্ধতিটি একটি সম্পদের জন্য প্রদত্ত সমস্ত মেটাডেটার একটি তালিকা প্রদান করে, কোন বিষয়বস্তুর মালিক ডেটা প্রদান করেছেন তা নির্বিশেষে। অনুরোধের assetId প্যারামিটারটি সেই সম্পদকে চিহ্নিত করে যার জন্য ডেটা পুনরুদ্ধার করা হচ্ছে।

  • যদি API অনুরোধ একটি shareId নির্দিষ্ট করে, API সেই কম্পোজিশন শেয়ারের জন্য সবচেয়ে সাম্প্রতিক মেটাডেটা প্রদান করে।

  • যদি API অনুরোধ একটি viewId নির্দিষ্ট করে, তাহলে API একটি তালিকা প্রদান করে যেখানে প্রতিটি এন্ট্রিতে সেই কম্পোজিশন ভিউয়ের সাথে লিঙ্ক করা যেকোনো কম্পোজিশন শেয়ারের জন্য দেওয়া মেটাডেটার সর্বশেষ সেট থাকে।

মালিকানা

এই পদ্ধতিটি একটি নির্দিষ্ট সম্পদের জন্য সংজ্ঞায়িত মালিকানা ডেটা প্রদান করে। অনুরোধের assetId প্যারামিটার সম্পদটিকে চিহ্নিত করে।

  • যদি assetId প্যারামিটার একটি shareId নির্দিষ্ট করে, তাহলে API প্রতিক্রিয়াতে মালিকানা ডেটা থাকে যা সামগ্রীর মালিক কম্পোজিশন শেয়ারের জন্য সেট করা API অনুরোধ অনুমোদন করে।
  • যদি assetId প্যারামিটার একটি viewId নির্দিষ্ট করে, তাহলে API কম্পোজিশন ভিউয়ের জন্য মালিকানা ডেটার ক্যানোনিকাল সেট প্রদান করে। প্রতিক্রিয়াটি viewId সাথে লিঙ্ক করা সমস্ত কম্পোজিশন শেয়ারের জন্য প্রদত্ত মালিকানা ডেটা সংশ্লেষিত করে, কোন বিষয়বস্তুর মালিকরা সেই শেয়ারগুলির মালিক হন না কেন।

মালিকানা.আপডেট এবং মালিকানা.প্যাচ৷

এই পদ্ধতিগুলি একটি নির্দিষ্ট সম্পদের জন্য মালিকানা ডেটা আপডেট করে। অনুরোধের assetId প্যারামিটার সম্পদটিকে চিহ্নিত করে।

  • যদি assetId প্যারামিটার একটি shareId নির্দিষ্ট করে, তাহলে API অনুরোধ সেই কম্পোজিশন শেয়ারের মালিকানা ডেটা আপডেট করে।
  • যদি assetId প্যারামিটার একটি viewId নির্দিষ্ট করে, এবং অনুরোধ অনুমোদনকারী সামগ্রীর মালিক শুধুমাত্র একটি কম্পোজিশন শেয়ারের মালিক হন যা সেই viewId এর সাথে লিঙ্ক করা হয়, তাহলে API অনুরোধ সেই কম্পোজিশন শেয়ারের মালিকানা ডেটা আপডেট করে।
  • যদি assetId প্যারামিটার একটি viewId নির্দিষ্ট করে, এবং অনুরোধের অনুমোদনকারী সামগ্রীর মালিক সেই viewId সাথে লিঙ্ক করা একাধিক রচনা শেয়ারের মালিক হন, তাহলে API অনুরোধটি একটি 400 ত্রুটি প্রদান করে।

মালিকানা ইতিহাস.তালিকা

এই পদ্ধতিটি একটি সম্পদের জন্য প্রদত্ত সমস্ত মালিকানা ডেটার একটি তালিকা প্রদান করে, কোন সামগ্রীর মালিক ডেটা প্রদান করেন তা নির্বিশেষে। অনুরোধের assetId প্যারামিটারটি সেই সম্পদকে চিহ্নিত করে যার জন্য ডেটা পুনরুদ্ধার করা হচ্ছে।

  • যদি API অনুরোধ একটি shareId নির্দিষ্ট করে, API সেই কম্পোজিশন শেয়ারের জন্য মালিকানা ডেটার সবচেয়ে সাম্প্রতিক সেট ফেরত দেয়।

  • যদি API অনুরোধ একটি viewId নির্দিষ্ট করে, তাহলে API একটি তালিকা প্রদান করে যেখানে প্রতিটি এন্ট্রিতে সেই কম্পোজিশন ভিউয়ের সাথে লিঙ্ক করা যেকোনো কম্পোজিশন শেয়ারের জন্য প্রদত্ত মালিকানা ডেটার সর্বশেষ সেট থাকে।