Method: references.insert

יוצרים קובץ עזר באחת מהדרכים הבאות:

  • אם בבקשה שלכם מופיע קובץ עזר, מערכת YouTube יוצרת את קובץ העזר מהתוכן שסיפקתם. אפשר לספק קובץ וידאו/אודיו או טביעת אצבע שנוצרה מראש. אם אתם מספקים טביעת אצבע שנוצרה מראש, מגדירים את המאפיין fpDirect של המשאב reference לערך true בגוף הבקשה. בתהליך הזה, אפשר להשתמש בתהליכי ההעלאה המרובים או הניתנים להמשך כדי לספק את תוכן העזר.
  • אם רוצים ליצור קובץ עזר באמצעות סרטון שהוגשה לגביו תלונה על הפרת זכויות יוצרים כתוכן העזר, משתמשים בפרמטר claimId כדי לזהות את התלונה.

בקשת HTTP

  • URI להעלאה, לבקשות העלאה של מדיה:
    POST https://youtubepartner.googleapis.com/upload/youtube/partner/v1/references
  • URI של מטא-נתונים, לבקשות של מטא-נתונים בלבד:
    POST https://youtubepartner.googleapis.com/youtube/partner/v1/references

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של שאילתה

פרמטרים
claimId

string

הפרמטר claimId מציין את מזהה התלונה ב-YouTube של תלונה קיימת שממנה צריך ליצור הפניה. (הסרטון שעליו הוגשה התלונה משמש כתוכן העזר).
onBehalfOfContentOwner

string

הפרמטר onBehalfOfContentOwner מזהה את בעלי התוכן בשם מי המשתמש פועל. הפרמטר הזה תומך במשתמשים שהחשבונות שלהם משויכים למספר בעלי תוכן.

גוף הבקשה

גוף הבקשה מכיל מופע של Reference.

גוף התשובה

אם הפעולה מצליחה, גוף התגובה מכיל מופע של Reference.

היקפי הרשאה

נדרש היקף הרשאות OAuth הבא:

  • https://www.googleapis.com/auth/youtubepartner

מידע נוסף זמין בOAuth 2.0 Overview.