Subscriptions: insert

הוספת מינוי לערוץ של המשתמש המאומת.

השפעה על המכסה: העלות של קריאה לשיטה הזו היא 50 יחידות מכסה.

תרחישים נפוצים לדוגמה

בקשה

בקשת HTTP

POST https://www.googleapis.com/youtube/v3/subscriptions

אישור

כדי לבצע את הבקשה הזו נדרשת הרשאה עם לפחות אחת מההרשאות הבאות (מידע נוסף על אימות והרשאה).

היקף
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

פרמטרים

בטבלה הבאה מפורטים הפרמטרים שהשאילתה הזו תומכת בהם. כל הפרמטרים שמופיעים ברשימה הם פרמטרים של שאילתה.

פרמטרים
פרמטרים נדרשים
part string
לפרמטר part יש שתי מטרות בפעולה הזו. הוא מציין את המאפיינים שפעולת הכתיבה תגדיר, וגם את המאפיינים שתגובה מה-API תכלול.

הרשימה הבאה מכילה את השמות של part שאפשר לכלול בערך הפרמטר:
  • contentDetails
  • id
  • snippet
  • subscriberSnippet

גוף הבקשה

מציינים משאב מינוי בגוף הבקשה. במשאב הזה:

  • צריך לציין ערך למאפיינים הבאים:

    • snippet.resourceId

  • אפשר להגדיר ערכים למאפיינים הבאים:

    • snippet.resourceId

תשובה

אם הפעולה בוצעה ללא שגיאות, ה-method מחזירה משאב מינוי בגוף התגובה.

שגיאות

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

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) subscriptionDuplicate המינוי שניסית ליצור כבר קיים.
badRequest (400) subscriptionForbidden הגעת למספר המקסימלי של מינויים.
badRequest (400) subscriptionForbidden אי אפשר להירשם לערוץ שלכם.
badRequest (400) subscriptionForbidden יותר מדי מינויים לאחרונה. אפשר לנסות שוב בעוד מספר שעות.
forbidden (403) subscriptionForbidden הבקשה לא מאומתת כמו שצריך או שהיא לא נתמכת בערוץ הזה.
notFound (404) publisherNotFound לא ניתן למצוא את המשאב שצוין במאפיין snippet.resourceId של הבקשה.
notFound (404) subscriberNotFound המנוי שזוהה עם הבקשה לא נמצא.
required (400) publisherRequired במשאב המינוי שצוין בבקשה צריך להשתמש במאפיין snippet.resourceId כדי לזהות את הערוץ שאליו נרשמים.

רוצה לנסות?

משתמשים ב-APIs Explorer כדי להפעיל את ה-API הזה ולראות את בקשת ה-API והתגובה.