‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

Subscriptions: insert

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

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

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

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`

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

אם הפעולה בוצעה ללא שגיאות, ה-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 והתגובה.