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

תשובה

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

שגיאות

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

סוג השגיאה פרטי השגיאה תיאור
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 ואת התשובה.