MembershipsLevels: list

הערה: רק יוצרים בודדים יכולים להשתמש בנקודת הקצה הזו כדי לשלוח בקשות לערוץ YouTube משלהם שבו מופעלת התכונה 'מועדון החברים של הערוץ'. אפשר לפנות לנציג Google או YouTube כדי לבקש גישה.

רשימת הרמות במועדון החברים של הערוץ שאישר את הבקשה. הרמות מוחזרות לפי סדר תצוגה מרומז. בקשות 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 תכלול. ערך הפרמטר הוא רשימה של חלקי משאבים שמופרדים בפסיקים. ברשימה הבאה מפורטים החלקים שניתן לאחזר:
  • id
  • snippet

גוף הבקשה

אין להזין גוף בקשה בעת הפעלת שיטה זו.

תשובה

אם התגובה מוצלחת, שיטה זו תחזיר גוף תגובה בעל המבנה הבא:

{
  "kind": "youtube#membershipsLevelListResponse",
  "etag": etag,
  "items": [
    membershipsLevel Resource
  ]
}

נכסים

הטבלה הבאה מגדירה את המאפיינים שמופיעים במשאב הזה:

נכסים
kind string
מזהה את סוג המשאב של ה-API. הערך יהיה youtube#membershipsLevelListResponse.
etag etag
התג של המשאב הזה.
items[] list
רשימה של membershipsLevel משאבים שבבעלות הערוץ שאישרו את בקשת ה-API.

שגיאות

הטבלה הבאה מזהה הודעות שגיאה שה-API יכול להחזיר בתגובה לקריאה לשיטה הזו. מידע נוסף זמין בתיעוד של הודעת השגיאה.

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) channelMembershipsNotEnabled הערוץ שהפעיל את בקשת ההרשאה לא הפעיל את התכונה 'מועדון החברים של הערוץ'.