GroupItems: insert

একটি গ্রুপ আইটেম তৈরি করে।

অনুরোধ

HTTP অনুরোধ

POST https://youtubeanalytics.googleapis.com/v2/groupItems

অনুমোদন

এই অনুরোধের জন্য নিম্নলিখিত স্কোপের মধ্যে অন্তত একটির অনুমোদন প্রয়োজন ( প্রমাণিকরণ এবং অনুমোদন সম্পর্কে আরও পড়ুন )।

স্কোপ
https://www.googleapis.com/auth/yt-analytics.readonly আপনার YouTube সামগ্রীর জন্য YouTube বিশ্লেষণ প্রতিবেদনগুলি দেখুন৷ এই সুযোগ ব্যবহারকারীর কার্যকলাপ মেট্রিক্সে অ্যাক্সেস প্রদান করে, যেমন ভিউ সংখ্যা এবং রেটিং গণনা।
https://www.googleapis.com/auth/yt-analytics-monetary.readonly আপনার YouTube বিষয়বস্তুর জন্য YouTube Analytics আর্থিক প্রতিবেদনগুলি দেখুন৷ এই সুযোগ ব্যবহারকারী কার্যকলাপ মেট্রিক্স এবং আনুমানিক আয় এবং বিজ্ঞাপন কর্মক্ষমতা মেট্রিক্স অ্যাক্সেস প্রদান করে.
https://www.googleapis.com/auth/youtube আপনার YouTube অ্যাকাউন্ট পরিচালনা করুন। ইউটিউব অ্যানালিটিক্স এপিআই-এ, চ্যানেল মালিকরা ইউটিউব অ্যানালিটিক্স গ্রুপ এবং গ্রুপ আইটেমগুলি পরিচালনা করতে এই সুযোগটি ব্যবহার করে।
https://www.googleapis.com/auth/youtubepartner YouTube এ YouTube সম্পদ এবং সংশ্লিষ্ট বিষয়বস্তু দেখুন ও পরিচালনা করুন। ইউটিউব অ্যানালিটিক্স এপিআই-এ, কন্টেন্ট মালিকরা ইউটিউব অ্যানালিটিক্স গ্রুপ এবং গ্রুপ আইটেমগুলি পরিচালনা করতে এই সুযোগটি ব্যবহার করে।

পরামিতি

নীচের সারণীটি এই ক্যোয়ারী সমর্থন করে এমন প্যারামিটারগুলিকে তালিকাভুক্ত করে৷ তালিকাভুক্ত সমস্ত প্যারামিটার হল ক্যোয়ারী প্যারামিটার।

পরামিতি
ঐচ্ছিক পরামিতি
onBehalfOfContentOwner string
এই প্যারামিটারটি শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। দ্রষ্টব্য: এই প্যারামিটারটি একচেটিয়াভাবে YouTube সামগ্রী অংশীদারদের জন্য যারা বিভিন্ন YouTube চ্যানেলের মালিক এবং পরিচালনা করে।

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

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

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

  • groupId
  • resource.id

প্রতিক্রিয়া

আইটেমটি সফলভাবে সন্নিবেশ করা হলে, এই পদ্ধতিটি প্রতিক্রিয়া বডিতে একটি গ্রুপ আইটেম সম্পদ ফেরত দেয়।

অনুরোধে উল্লিখিত আইটেমটি অনুরোধ করার আগে গ্রুপে অন্তর্ভুক্ত করা থাকলে, এই পদ্ধতিটি একটি HTTP 204 প্রতিক্রিয়া কোড প্রদান করে ( No Content )।

ত্রুটি

নীচের সারণী ত্রুটি বার্তাগুলি সনাক্ত করে যেগুলি API এই পদ্ধতিতে একটি কলের প্রতিক্রিয়া হিসাবে ফিরে আসতে পারে৷ আরো বিস্তারিত জানার জন্য ত্রুটি বার্তা ডকুমেন্টেশন দেখুন.

ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা
forbidden (403) groupContainsMaximumNumberOfItems গ্রুপে ইতিমধ্যেই সর্বাধিক অনুমোদিত সংখ্যক আইটেম রয়েছে৷

এটা চেষ্টা করুন!

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