Sponsors

הערה: המשאב הזה הוצא משימוש ב-31 במרץ 2020. הוא הוחלף על ידי המשאב member. אפשר למצוא מידע על המשאב הזה במסמכי התיעוד של YouTube Data API.

כחלק מההוצאה משימוש, החל מ-30 בספטמבר 2020 לא תהיה יותר תמיכה בשיטה sponsors.list. לקוחות API צריכים לעדכן את הקריאות לשיטה sponsors.list כדי להשתמש בשיטת members.list במקום זאת.

משאב sponsor מייצג חבר מועדון (לשעבר "מתן חסות") עבור ערוץ YouTube. חברי המועדון מקבלים תמיכה כספית קבועה ליוצרים, ונהנים מהטבות מיוחדות. לדוגמה, חברי מועדון יכולים לנהל צ'אט כאשר היוצרים מפעילים מצב 'לחברי מועדון בלבד' בצ'אט.

שיטות

ה-API תומך בשיטות הבאות עבור משאבי sponsors:

list
רשימת נותני חסות לערוץ. בקשת ה-API חייבת לקבל הרשאה מהבעלים של הערוץ. כדאי לנסות עכשיו.

ייצוג משאבים

המבנה הבא של JSON מציג את הפורמט של משאב sponsors:

{
  "kind": "youtube#sponsor",
  "etag": etag,
  "id": string,
  "snippet": {
    "channelId": string,
    "sponsorDetails": {
      "channelId": string,
      "channelUrl": string,
      "displayName": string,
      "profileImageUrl": string
    },
    "sponsorSince": datetime
  }
}

נכסים

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

נכסים
kind string
מזהה את סוג המשאב של ה-API. הערך יהיה youtube#sponsor.
etag etag
התג של המשאב הזה.
id string
המזהה ש-YouTube מקצה כדי לזהות באופן ייחודי את נותן החסות.
snippet object
האובייקט snippet כולל פרטים על נותן החסות.
snippet.channelId string
המזהה הזה משמש לזיהוי הערוץ הממומן.
snippet.sponsorDetails object
האובייקט הזה מכיל פרטים על נותן החסות.
snippet.sponsorDetails.channelId string
מזהה הערוץ ב-YouTube.
snippet.sponsorDetails.channelUrl string
כתובת ה-URL של הערוץ.
snippet.sponsorDetails.displayName string
השם המוצג של הערוץ.
snippet.sponsorDetails.profileImageUrl string
כתובת ה-URL של הדמות של הערוץ.
snippet.sponsorSince datetime
התאריך והשעה שבהם המשתמש קיבל חסות. הערך צוין בפורמט ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).