API অনুরোধের পরামিতিগুলির সাথে মেলে এমন গোষ্ঠীগুলির একটি তালিকা প্রদান করে৷ উদাহরণস্বরূপ, আপনি প্রমাণীকৃত ব্যবহারকারীর মালিকানাধীন সমস্ত গ্রুপ পুনরুদ্ধার করতে পারেন, অথবা আপনি তাদের অনন্য আইডি দ্বারা এক বা একাধিক গোষ্ঠী পুনরুদ্ধার করতে পারেন।
অনুরোধ
HTTP অনুরোধ
GET https://youtubeanalytics.googleapis.com/v2/groups
অনুমোদন
এই অনুরোধের জন্য নিম্নলিখিত স্কোপের মধ্যে অন্তত একটির অনুমোদন প্রয়োজন ( প্রমাণিকরণ এবং অনুমোদন সম্পর্কে আরও পড়ুন )।
| স্কোপ | |
|---|---|
| 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 সম্পদ এবং সংশ্লিষ্ট বিষয়বস্তু দেখুন ও পরিচালনা করুন। ইউটিউব অ্যানালিটিক্স এপিআই-এ, কন্টেন্ট মালিকরা ইউটিউব অ্যানালিটিক্স গ্রুপ এবং গ্রুপ আইটেমগুলি পরিচালনা করতে এই সুযোগটি ব্যবহার করে। |
পরামিতি
নীচের সারণীটি এই ক্যোয়ারী সমর্থন করে এমন প্যারামিটারগুলিকে তালিকাভুক্ত করে৷ তালিকাভুক্ত সমস্ত প্যারামিটার হল ক্যোয়ারী প্যারামিটার।
| পরামিতি | ||
|---|---|---|
| ফিল্টার (নিম্নলিখিত পরামিতিগুলির মধ্যে একটি নির্দিষ্ট করুন) | ||
id | stringid প্যারামিটারটি পুনরুদ্ধার করা সংস্থানগুলির জন্য YouTube গ্রুপ আইডি(গুলি) এর একটি কমা দ্বারা পৃথক করা তালিকা নির্দিষ্ট করে৷ প্রতিটি গোষ্ঠী অবশ্যই প্রমাণীকৃত ব্যবহারকারীর মালিকানাধীন হতে হবে। একটি group রিসোর্সে, id প্রপার্টি গ্রুপের YouTube গ্রুপ আইডি নির্দিষ্ট করে।মনে রাখবেন যে আপনি যদি id প্যারামিটারের জন্য একটি মান নির্দিষ্ট না করেন, তাহলে আপনাকে অবশ্যই mine প্যারামিটারটি true সেট করতে হবে। | |
mine | booleanএই প্যারামিটারটি শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। প্রমাণীকৃত ব্যবহারকারীর মালিকানাধীন সমস্ত গ্রুপ পুনরুদ্ধার করতে এই প্যারামিটারের মান true সেট করুন। | |
| ঐচ্ছিক পরামিতি | ||
onBehalfOfContentOwner | stringএই প্যারামিটারটি শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। দ্রষ্টব্য: এই প্যারামিটারটি একচেটিয়াভাবে YouTube সামগ্রী অংশীদারদের জন্য যারা বিভিন্ন YouTube চ্যানেলের মালিক এবং পরিচালনা করে৷ onBehalfOfContentOwner প্যারামিটারটি নির্দেশ করে যে অনুরোধের অনুমোদনের শংসাপত্রগুলি একজন YouTube ব্যবহারকারীকে শনাক্ত করে যিনি প্যারামিটার মানতে নির্দিষ্ট করা সামগ্রীর মালিকের পক্ষে কাজ করছেন৷ এটি সামগ্রীর মালিকদের একবার প্রমাণীকরণ করতে এবং প্রতিটি পৃথক চ্যানেলের জন্য প্রমাণীকরণ শংসাপত্র প্রদান না করেই তাদের সমস্ত ভিডিও এবং চ্যানেল ডেটাতে অ্যাক্সেস পেতে দেয়৷ ব্যবহারকারী যে অ্যাকাউন্টের সাথে প্রমাণীকরণ করে সেটি অবশ্যই নির্দিষ্ট YouTube বিষয়বস্তুর মালিকের সাথে লিঙ্ক করা উচিত। | |
pageToken | stringpageToken প্যারামিটার ফলাফল সেটে একটি নির্দিষ্ট পৃষ্ঠা চিহ্নিত করে যা ফেরত দেওয়া উচিত। একটি এপিআই প্রতিক্রিয়াতে, nextPageToken প্রপার্টি পরবর্তী পৃষ্ঠাটিকে চিহ্নিত করে যা পুনরুদ্ধার করা যেতে পারে। | |
শরীরের অনুরোধ
এই পদ্ধতিতে কল করার সময় একটি অনুরোধের অংশ প্রদান করবেন না।
প্রতিক্রিয়া
সফল হলে, এই পদ্ধতিটি নিম্নলিখিত কাঠামো সহ একটি প্রতিক্রিয়া বডি প্রদান করে:
{
"kind": "youtube#groupListResponse",
"etag": etag,
"items": [
group Resource
],
"nextPageToken": string
}বৈশিষ্ট্য
নিম্নলিখিত সারণী এই সম্পদে প্রদর্শিত বৈশিষ্ট্যগুলিকে সংজ্ঞায়িত করে:
| বৈশিষ্ট্য | |
|---|---|
kind | stringAPI সম্পদের ধরন সনাক্ত করে। মান হবে youtube#groupListResponse । |
etag | etagএই সম্পদের Etag. |
items[] | listAPI অনুরোধের পরামিতিগুলির সাথে মেলে এমন গোষ্ঠীগুলির একটি তালিকা৷ তালিকার প্রতিটি আইটেম একটি group সম্পদ প্রতিনিধিত্ব করে। |
nextPageToken | stringফলাফল সেটের পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে pageToken প্যারামিটারের মান হিসাবে টোকেন ব্যবহার করা যেতে পারে। |
ত্রুটি
API এই API পদ্ধতির অনন্য কোনো ত্রুটি বার্তা সংজ্ঞায়িত করে না। যাইহোক, এই পদ্ধতিটি এখনও ত্রুটি বার্তা ডকুমেন্টেশনে তালিকাভুক্ত সাধারণ API ত্রুটিগুলি ফিরিয়ে দিতে পারে।
এটা চেষ্টা করুন!
এই API কল করতে APIs Explorer ব্যবহার করুন এবং API অনুরোধ এবং প্রতিক্রিয়া দেখুন।
API অনুরোধের পরামিতিগুলির সাথে মেলে এমন গোষ্ঠীগুলির একটি তালিকা প্রদান করে৷ উদাহরণস্বরূপ, আপনি প্রমাণীকৃত ব্যবহারকারীর মালিকানাধীন সমস্ত গ্রুপ পুনরুদ্ধার করতে পারেন, অথবা আপনি তাদের অনন্য আইডি দ্বারা এক বা একাধিক গোষ্ঠী পুনরুদ্ধার করতে পারেন।
অনুরোধ
HTTP অনুরোধ
GET https://youtubeanalytics.googleapis.com/v2/groups
অনুমোদন
এই অনুরোধের জন্য নিম্নলিখিত স্কোপের মধ্যে অন্তত একটির অনুমোদন প্রয়োজন ( প্রমাণিকরণ এবং অনুমোদন সম্পর্কে আরও পড়ুন )।
| স্কোপ | |
|---|---|
| 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 সম্পদ এবং সংশ্লিষ্ট বিষয়বস্তু দেখুন ও পরিচালনা করুন। ইউটিউব অ্যানালিটিক্স এপিআই-এ, কন্টেন্ট মালিকরা ইউটিউব অ্যানালিটিক্স গ্রুপ এবং গ্রুপ আইটেমগুলি পরিচালনা করতে এই সুযোগটি ব্যবহার করে। |
পরামিতি
নীচের সারণীটি এই ক্যোয়ারী সমর্থন করে এমন প্যারামিটারগুলিকে তালিকাভুক্ত করে৷ তালিকাভুক্ত সমস্ত প্যারামিটার হল ক্যোয়ারী প্যারামিটার।
| পরামিতি | ||
|---|---|---|
| ফিল্টার (নিম্নলিখিত পরামিতিগুলির মধ্যে একটি নির্দিষ্ট করুন) | ||
id | stringid প্যারামিটারটি পুনরুদ্ধার করা সংস্থানগুলির জন্য YouTube গ্রুপ আইডি(গুলি) এর একটি কমা দ্বারা পৃথক করা তালিকা নির্দিষ্ট করে৷ প্রতিটি গোষ্ঠী অবশ্যই প্রমাণীকৃত ব্যবহারকারীর মালিকানাধীন হতে হবে। একটি group রিসোর্সে, id প্রপার্টি গ্রুপের YouTube গ্রুপ আইডি নির্দিষ্ট করে।মনে রাখবেন যে আপনি যদি id প্যারামিটারের জন্য একটি মান নির্দিষ্ট না করেন, তাহলে আপনাকে অবশ্যই mine প্যারামিটারটি true সেট করতে হবে। | |
mine | booleanএই প্যারামিটারটি শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। প্রমাণীকৃত ব্যবহারকারীর মালিকানাধীন সমস্ত গ্রুপ পুনরুদ্ধার করতে এই প্যারামিটারের মান true সেট করুন। | |
| ঐচ্ছিক পরামিতি | ||
onBehalfOfContentOwner | stringএই প্যারামিটারটি শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। দ্রষ্টব্য: এই প্যারামিটারটি একচেটিয়াভাবে YouTube সামগ্রী অংশীদারদের জন্য যারা বিভিন্ন YouTube চ্যানেলের মালিক এবং পরিচালনা করে। onBehalfOfContentOwner প্যারামিটারটি নির্দেশ করে যে অনুরোধের অনুমোদনের শংসাপত্রগুলি একজন YouTube ব্যবহারকারীকে শনাক্ত করে যিনি প্যারামিটার মানতে নির্দিষ্ট করা সামগ্রীর মালিকের পক্ষে কাজ করছেন৷ এটি সামগ্রীর মালিকদের একবার প্রমাণীকরণ করতে এবং প্রতিটি পৃথক চ্যানেলের জন্য প্রমাণীকরণ শংসাপত্র প্রদান না করেই তাদের সমস্ত ভিডিও এবং চ্যানেল ডেটাতে অ্যাক্সেস পেতে দেয়৷ ব্যবহারকারী যে অ্যাকাউন্টের সাথে প্রমাণীকরণ করে সেটি অবশ্যই নির্দিষ্ট YouTube বিষয়বস্তুর মালিকের সাথে লিঙ্ক করা উচিত। | |
pageToken | stringpageToken প্যারামিটার ফলাফল সেটে একটি নির্দিষ্ট পৃষ্ঠা চিহ্নিত করে যা ফেরত দেওয়া উচিত। একটি এপিআই প্রতিক্রিয়াতে, nextPageToken প্রপার্টি পরবর্তী পৃষ্ঠাটিকে চিহ্নিত করে যা পুনরুদ্ধার করা যেতে পারে। | |
শরীরের অনুরোধ
এই পদ্ধতিতে কল করার সময় একটি অনুরোধের অংশ প্রদান করবেন না।
প্রতিক্রিয়া
সফল হলে, এই পদ্ধতিটি নিম্নলিখিত কাঠামো সহ একটি প্রতিক্রিয়া বডি প্রদান করে:
{
"kind": "youtube#groupListResponse",
"etag": etag,
"items": [
group Resource
],
"nextPageToken": string
}বৈশিষ্ট্য
নিম্নলিখিত সারণী এই সম্পদে প্রদর্শিত বৈশিষ্ট্যগুলিকে সংজ্ঞায়িত করে:
| বৈশিষ্ট্য | |
|---|---|
kind | stringAPI সম্পদের ধরন সনাক্ত করে। মান হবে youtube#groupListResponse । |
etag | etagএই সম্পদের Etag. |
items[] | listAPI অনুরোধের পরামিতিগুলির সাথে মেলে এমন গোষ্ঠীগুলির একটি তালিকা৷ তালিকার প্রতিটি আইটেম একটি group সম্পদ প্রতিনিধিত্ব করে। |
nextPageToken | stringফলাফল সেটের পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে pageToken প্যারামিটারের মান হিসাবে টোকেন ব্যবহার করা যেতে পারে। |
ত্রুটি
API এই API পদ্ধতির অনন্য কোনো ত্রুটি বার্তা সংজ্ঞায়িত করে না। যাইহোক, এই পদ্ধতিটি এখনও ত্রুটি বার্তা ডকুমেন্টেশনে তালিকাভুক্ত সাধারণ API ত্রুটিগুলি ফিরিয়ে দিতে পারে।
এটা চেষ্টা করুন!
এই API কল করতে APIs Explorer ব্যবহার করুন এবং API অনুরোধ এবং প্রতিক্রিয়া দেখুন।
API অনুরোধের পরামিতিগুলির সাথে মেলে এমন গোষ্ঠীগুলির একটি তালিকা প্রদান করে৷ উদাহরণস্বরূপ, আপনি প্রমাণীকৃত ব্যবহারকারীর মালিকানাধীন সমস্ত গ্রুপ পুনরুদ্ধার করতে পারেন, অথবা আপনি তাদের অনন্য আইডি দ্বারা এক বা একাধিক গোষ্ঠী পুনরুদ্ধার করতে পারেন।
অনুরোধ
HTTP অনুরোধ
GET https://youtubeanalytics.googleapis.com/v2/groups
অনুমোদন
এই অনুরোধের জন্য নিম্নলিখিত স্কোপের মধ্যে অন্তত একটির অনুমোদন প্রয়োজন ( প্রমাণিকরণ এবং অনুমোদন সম্পর্কে আরও পড়ুন )।
| স্কোপ | |
|---|---|
| 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 সম্পদ এবং সংশ্লিষ্ট বিষয়বস্তু দেখুন ও পরিচালনা করুন। ইউটিউব অ্যানালিটিক্স এপিআই-এ, কন্টেন্ট মালিকরা ইউটিউব অ্যানালিটিক্স গ্রুপ এবং গ্রুপ আইটেমগুলি পরিচালনা করতে এই সুযোগটি ব্যবহার করে। |
পরামিতি
নীচের সারণীটি এই ক্যোয়ারী সমর্থন করে এমন প্যারামিটারগুলিকে তালিকাভুক্ত করে৷ তালিকাভুক্ত সমস্ত প্যারামিটার হল ক্যোয়ারী প্যারামিটার।
| পরামিতি | ||
|---|---|---|
| ফিল্টার (নিম্নলিখিত পরামিতিগুলির মধ্যে একটি নির্দিষ্ট করুন) | ||
id | stringid প্যারামিটারটি পুনরুদ্ধার করা সংস্থানগুলির জন্য YouTube গ্রুপ আইডি(গুলি) এর একটি কমা দ্বারা পৃথক করা তালিকা নির্দিষ্ট করে৷ প্রতিটি গোষ্ঠী অবশ্যই প্রমাণীকৃত ব্যবহারকারীর মালিকানাধীন হতে হবে। একটি group রিসোর্সে, id প্রপার্টি গ্রুপের YouTube গ্রুপ আইডি নির্দিষ্ট করে।মনে রাখবেন যে আপনি যদি id প্যারামিটারের জন্য একটি মান নির্দিষ্ট না করেন, তাহলে আপনাকে অবশ্যই mine প্যারামিটারটি true সেট করতে হবে। | |
mine | booleanএই প্যারামিটারটি শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। প্রমাণীকৃত ব্যবহারকারীর মালিকানাধীন সমস্ত গ্রুপ পুনরুদ্ধার করতে এই প্যারামিটারের মান true সেট করুন। | |
| ঐচ্ছিক পরামিতি | ||
onBehalfOfContentOwner | stringএই প্যারামিটারটি শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। দ্রষ্টব্য: এই প্যারামিটারটি একচেটিয়াভাবে YouTube সামগ্রী অংশীদারদের জন্য যারা বিভিন্ন YouTube চ্যানেলের মালিক এবং পরিচালনা করে৷ onBehalfOfContentOwner প্যারামিটারটি নির্দেশ করে যে অনুরোধের অনুমোদনের শংসাপত্রগুলি একজন YouTube ব্যবহারকারীকে শনাক্ত করে যিনি প্যারামিটার মানতে নির্দিষ্ট করা সামগ্রীর মালিকের পক্ষে কাজ করছেন৷ এটি সামগ্রীর মালিকদের একবার প্রমাণীকরণ করতে এবং প্রতিটি পৃথক চ্যানেলের জন্য প্রমাণীকরণ শংসাপত্র প্রদান না করেই তাদের সমস্ত ভিডিও এবং চ্যানেল ডেটাতে অ্যাক্সেস পেতে দেয়৷ ব্যবহারকারী যে অ্যাকাউন্টের সাথে প্রমাণীকরণ করে সেটি অবশ্যই নির্দিষ্ট YouTube বিষয়বস্তুর মালিকের সাথে লিঙ্ক করা উচিত। | |
pageToken | stringpageToken প্যারামিটার ফলাফল সেটে একটি নির্দিষ্ট পৃষ্ঠা চিহ্নিত করে যা ফেরত দেওয়া উচিত। একটি এপিআই প্রতিক্রিয়াতে, nextPageToken প্রপার্টি পরবর্তী পৃষ্ঠাটিকে চিহ্নিত করে যা পুনরুদ্ধার করা যেতে পারে। | |
শরীরের অনুরোধ
এই পদ্ধতিতে কল করার সময় একটি অনুরোধের অংশ প্রদান করবেন না।
প্রতিক্রিয়া
সফল হলে, এই পদ্ধতিটি নিম্নলিখিত কাঠামো সহ একটি প্রতিক্রিয়া বডি প্রদান করে:
{
"kind": "youtube#groupListResponse",
"etag": etag,
"items": [
group Resource
],
"nextPageToken": string
}বৈশিষ্ট্য
নিম্নলিখিত সারণী এই সম্পদে প্রদর্শিত বৈশিষ্ট্যগুলিকে সংজ্ঞায়িত করে:
| বৈশিষ্ট্য | |
|---|---|
kind | stringAPI সম্পদের ধরন সনাক্ত করে। মান হবে youtube#groupListResponse । |
etag | etagএই সম্পদের Etag. |
items[] | listAPI অনুরোধের পরামিতিগুলির সাথে মেলে এমন গোষ্ঠীগুলির একটি তালিকা৷ তালিকার প্রতিটি আইটেম একটি group সম্পদ প্রতিনিধিত্ব করে। |
nextPageToken | stringফলাফল সেটের পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে pageToken প্যারামিটারের মান হিসাবে টোকেন ব্যবহার করা যেতে পারে। |
ত্রুটি
API এই API পদ্ধতির অনন্য কোনো ত্রুটি বার্তা সংজ্ঞায়িত করে না। যাইহোক, এই পদ্ধতিটি এখনও ত্রুটি বার্তা ডকুমেন্টেশনে তালিকাভুক্ত সাধারণ API ত্রুটিগুলি ফিরিয়ে দিতে পারে।
এটা চেষ্টা করুন!
এই API কল করতে APIs Explorer ব্যবহার করুন এবং API অনুরোধ এবং প্রতিক্রিয়া দেখুন।