רשימת הרמות במועדון החברים של הערוץ שאישר את הבקשה. הרמות מוחזרות לפי סדר תצוגה מרומז. בקשות API לשיטה זו מניבות אחת מהתגובות הבאות:
- אם היוצר הפעיל מועדון חברים ויש לו רמות תמחור, תגובת ה-API תכלול את רשימת הרמות.
- אם היוצר הפעיל את מועדון החברים של הערוץ אבל לא הגדיר רמות תמחור, תגובת ה-API תכלול רשימה ריקה.
- אם היוצר לא הפעיל את התכונה 'מועדון החברים של הערוץ', ה-API יחזיר שגיאה
channelMembershipsNotEnabled
.
ההשפעה על המכסה: קריאה לשיטה זו כוללת עלות מכסה של יחידה אחת.
בקשה
בקשת HTTP
GET https://www.googleapis.com/youtube/v3/membershipsLevels
בקשה זו מחייבת הרשאה בהיקף הבא:
היקף |
---|
https://www.googleapis.com/auth/youtube.channel-memberships.creator |
פרמטרים
הטבלה הבאה מפרטת את הפרמטרים שנתמכים על ידי שאילתה זו. כל הפרמטרים המפורטים הם פרמטרים של שאילתה.
פרמטרים | ||
---|---|---|
פרמטרים נדרשים | ||
part |
string הפרמטר part מציין את מאפייני המשאבים של membershipsLevel שהתגובה ל-API תכלול. ערך הפרמטר הוא
רשימה של חלקי משאבים שמופרדים בפסיקים. ברשימה הבאה מפורטים החלקים שניתן לאחזר:
|
גוף הבקשה
אין להזין גוף בקשה בעת הפעלת שיטה זו.
תשובה
אם התגובה מוצלחת, שיטה זו תחזיר גוף תגובה בעל המבנה הבא:
{ "kind": "youtube#membershipsLevelListResponse", "etag": etag, "items": [ membershipsLevel Resource ] }
נכסים
הטבלה הבאה מגדירה את המאפיינים שמופיעים במשאב הזה:
נכסים | |
---|---|
kind |
string מזהה את סוג המשאב של ה-API. הערך יהיה youtube#membershipsLevelListResponse . |
etag |
etag התג של המשאב הזה. |
items[] |
list רשימה של membershipsLevel משאבים שבבעלות הערוץ שאישרו את בקשת ה-API. |
שגיאות
הטבלה הבאה מזהה הודעות שגיאה שה-API יכול להחזיר בתגובה לקריאה לשיטה הזו. מידע נוסף זמין בתיעוד של הודעת השגיאה.
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
badRequest (400) |
channelMembershipsNotEnabled |
הערוץ שהפעיל את בקשת ההרשאה לא הפעיל את התכונה 'מועדון החברים של הערוץ'. |