הערה: ממשק YouTube Content ID API מיועד לשימוש של שותפי תוכן של YouTube, והוא אינו נגיש לכל המפתחים או לכל משתמשי YouTube. אם אינכם רואים את YouTube Content ID API כאחד מהשירותים המפורטים בGoogle API Console, מומלץ לעיין במרכז העזרה של YouTube כדי לקבל מידע נוסף על תוכנית השותפים של YouTube.
רקע
חשבון שירות הוא חשבון Google שאפשר להשתמש בו כדי לאשר קריאות ל-API ללא אינטראקציה של המשתמש. בניגוד לתהליכי OAuth 2.0 אחרים, אימות ואישור הגישה באמצעות תהליך OAuth 2.0 לחשבונות שירות לא מתבצע בדפדפן אינטרנט. במקום זאת, OAuth 2.0 לחשבונות שירות מסתמך על חתימות קריפטוגרפיות כדי לאשר גישה. כל עוד לקוד שלכם יש גישה למפתח הקריפטוגרפי הבסיסי, הוא יכול להמשיך לבצע קריאות ל-API בלי לדאוג לגבי רענון ואסימוני גישה. הוא מושלם לאפליקציות אוטומטיות שפועלות בשרתים ללא התערבות אנושית.
עכשיו אפשר להשתמש ב-OAuth 2.0 לזרימה של חשבונות שירות כדי לאשר בקשות של Content ID API של YouTube. תוכלו להשתמש בתהליך הזה גם כדי לאשר קריאות ל-YouTube Data API ול-YouTube Analytics API בשיטות שתומכות בפרמטרים של הענקת גישה. בכל המקרים האלה, אפליקציה שמשתמשת בתהליך הזה מאשרת את בקשת ה-API כשותף תוכן של YouTube (באמצעות חשבון YouTube CMS) ולא כבעלים של ערוץ YouTube.
הגדרת חשבון השירות
צילומי המסך הבאים ממחישים את תהליך היצירה של חשבון שירות המשויך לפרויקט ה-API שלך, ועליך לוודא שכבר מופעלים בו ממשקי ה-API המתאימים (YouTube Data API v3, YouTube Analytics API, YouTube Content ID API וכו').
- נכנסים לכתובת https://cloud.google.com/console ובוחרים את פרויקט ה-API הקיים (או יוצרים פרויקט חדש).
- בסרגל הצד שמימין, בוחרים באפשרות ממשקי API והרשאה.
- חשוב לוודא ש-YouTube Content ID API מופעל בפרויקט.
- בסרגל הצד שמימין, בוחרים באפשרות פרטי כניסה.
- לוחצים על הלחצן יצירת מזהה לקוח חדש.
- בוחרים באפשרות Service account מתוך האפשרויות המפורטות ולוחצים על Create client ID (יצירת מזהה לקוח). תתבצע הורדה של המפתח הפרטי לחשבון השירות שלך למחשב. זהו העותק היחיד של המפתח ועליך לשמור את המפתח במיקום מאובטח שממנו האפליקציה יכולה לקרוא.
- רושמים לעצמכם את כתובת האימייל של חשבון השירות. (כתובת האימייל מופיעה בדף פרטי כניסה). תזדקק לכתובת כדי להעניק לחשבון השירות שלך את היכולת לגשת לחשבון YouTube CMS שלך.
- נכנסים לכתובת https://www.youtube.com/content_owner_users ולוחצים על הלחצן משתמש חדש.
- מזינים את כתובת האימייל של חשבון השירות משלב 7 בשדה כתובת אימייל ובוחרים את התפקיד המתאים למשתמש. לאחר מכן לוחצים על הלחצן שליחת הזמנה.
- חשבון השירות שלכם מקבל את ההזמנה באופן אוטומטי, וכתוצאה מכך חשבון זה יוכל לגשת לממשקי ה-API של YouTube הפועלים מטעם חשבון YouTube CMS שלכם.
- כדי לאשר בקשות באמצעות חשבון השירות שלכם, צריך לבצע את ההוראות לתהליך העבודה של חשבון שירות OAuth 2.0 במדריך בקשות הרשאה.
ביצוע קריאות ל-API
ברוב ספריות הלקוח של השפות יש תמיכה מובנית בזרימת OAuth 2.0 לחשבון שירות. עליך להיות מסוגל לעקוב אחר הדוגמאות במסמכי התיעוד של הספרייה כדי לבצע הרשאה בסיסית בהיקפים המתאימים של ממשק ה-API של YouTube.
הדבר החשוב ביותר שכדאי לזכור הוא שעליכם להשתמש בפרמטרים המתאימים להאצלה כדי לפעול מטעם ערוץ נתון המקושר לחשבון ה-CMS שלכם. כדי להציג רשימת ערוצים המקושרים לחשבון CMS שלך, בקר בכתובת https://cms.youtube.com/edit_user_accounts.