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
ה-e של המשאב הזה.
items[] list
רשימה של membershipsLevel משאבים בבעלות הערוץ שאישרו את בקשת ה-API.

שגיאות

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

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