MembershipsLevels: list

הערה: נקודת הקצה הזו מיועדת ליוצרים פרטיים בלבד, והם יכולים להשתמש בה כדי לשלוח בקשות לגבי ערוץ 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
ה-Etag של מקור המידע הזה.
items[] list
רשימה של משאבי membershipsLevel שנמצאים בבעלות הערוץ שאישר את בקשת ה-API.

שגיאות

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

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