GroupItems: list

গুরুত্বপূর্ণ: এই পদ্ধতিতে API অনুরোধগুলির যেকোন একটিতে অ্যাক্সেস প্রয়োজন:
  • https://www.googleapis.com/auth/youtube স্কোপ
    বা
  • https://www.googleapis.com/auth/youtube.readonly সুযোগ
    এবং
    https://www.googleapis.com/auth/yt-analytics.readonly সুযোগ

প্রথম বিকল্পটি একটি সুযোগ ব্যবহার করে, যা একটি পঠন-লেখার সুযোগ হিসাবে ঘটে, যখন দ্বিতীয় বিকল্পটি দুটি শুধুমাত্র-পঠন স্কোপ ব্যবহার করে।

API অনুরোধের পরামিতিগুলির সাথে মেলে এমন গ্রুপ আইটেমগুলির একটি সংগ্রহ প্রদান করে৷

অনুরোধ

HTTP অনুরোধ

GET 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 সম্পদ এবং সংশ্লিষ্ট বিষয়বস্তু দেখুন ও পরিচালনা করুন। ইউটিউব অ্যানালিটিক্স এপিআই-এ, কন্টেন্ট মালিকরা ইউটিউব অ্যানালিটিক্স গ্রুপ এবং গ্রুপ আইটেমগুলি পরিচালনা করতে এই সুযোগটি ব্যবহার করে।

পরামিতি

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

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

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

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

এই পদ্ধতিতে কল করার সময় একটি অনুরোধের অংশ প্রদান করবেন না।

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

সফল হলে, এই পদ্ধতিটি নিম্নলিখিত কাঠামো সহ একটি প্রতিক্রিয়া বডি প্রদান করে:

{
  "kind": "youtube#groupItemListResponse",
  "etag": etag,
  "items": [
    groupItem Resource
  ]
}

বৈশিষ্ট্য

নিম্নলিখিত সারণী এই সম্পদে প্রদর্শিত বৈশিষ্ট্যগুলিকে সংজ্ঞায়িত করে:

বৈশিষ্ট্য
kind string
API সম্পদের ধরন সনাক্ত করে। মান হবে youtube#groupItemListResponse
etag etag
এই সম্পদের Etag.
items[] list
গোষ্ঠীতে থাকা আইটেমগুলির একটি তালিকা৷ তালিকার প্রতিটি আইটেম একটি groupItem সম্পদ প্রতিনিধিত্ব করে।

ত্রুটি

API এই API পদ্ধতির অনন্য কোনো ত্রুটি বার্তা সংজ্ঞায়িত করে না। যাইহোক, এই পদ্ধতিটি এখনও ত্রুটি বার্তা ডকুমেন্টেশনে তালিকাভুক্ত সাধারণ API ত্রুটিগুলি ফিরিয়ে দিতে পারে।

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

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

,
গুরুত্বপূর্ণ: এই পদ্ধতিতে API অনুরোধগুলির যেকোন একটিতে অ্যাক্সেস প্রয়োজন:
  • https://www.googleapis.com/auth/youtube স্কোপ
    বা
  • https://www.googleapis.com/auth/youtube.readonly সুযোগ
    এবং
    https://www.googleapis.com/auth/yt-analytics.readonly সুযোগ

প্রথম বিকল্পটি একটি সুযোগ ব্যবহার করে, যা একটি পঠন-লেখার সুযোগ হিসাবে ঘটে, যখন দ্বিতীয় বিকল্পটি দুটি শুধুমাত্র-পঠন স্কোপ ব্যবহার করে।

API অনুরোধের পরামিতিগুলির সাথে মেলে এমন গ্রুপ আইটেমগুলির একটি সংগ্রহ প্রদান করে৷

অনুরোধ

HTTP অনুরোধ

GET 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 সম্পদ এবং সংশ্লিষ্ট বিষয়বস্তু দেখুন ও পরিচালনা করুন। ইউটিউব অ্যানালিটিক্স এপিআই-এ, কন্টেন্ট মালিকরা ইউটিউব অ্যানালিটিক্স গ্রুপ এবং গ্রুপ আইটেমগুলি পরিচালনা করতে এই সুযোগটি ব্যবহার করে।

পরামিতি

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

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

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

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

এই পদ্ধতিতে কল করার সময় একটি অনুরোধের অংশ প্রদান করবেন না।

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

সফল হলে, এই পদ্ধতিটি নিম্নলিখিত কাঠামো সহ একটি প্রতিক্রিয়া বডি প্রদান করে:

{
  "kind": "youtube#groupItemListResponse",
  "etag": etag,
  "items": [
    groupItem Resource
  ]
}

বৈশিষ্ট্য

নিম্নলিখিত সারণী এই সম্পদে প্রদর্শিত বৈশিষ্ট্যগুলিকে সংজ্ঞায়িত করে:

বৈশিষ্ট্য
kind string
API সম্পদের ধরন সনাক্ত করে। মান হবে youtube#groupItemListResponse
etag etag
এই সম্পদের Etag.
items[] list
গোষ্ঠীতে থাকা আইটেমগুলির একটি তালিকা৷ তালিকার প্রতিটি আইটেম একটি groupItem সম্পদ প্রতিনিধিত্ব করে।

ত্রুটি

API এই API পদ্ধতির অনন্য কোনো ত্রুটি বার্তা সংজ্ঞায়িত করে না। যাইহোক, এই পদ্ধতিটি এখনও ত্রুটি বার্তা ডকুমেন্টেশনে তালিকাভুক্ত সাধারণ API ত্রুটিগুলি ফিরিয়ে দিতে পারে।

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

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