Method: references.insert

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

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

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

פרמטרים
claimId

string

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

string

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

גוף הבקשה

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

גוף התגובה

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

היקפי הרשאות

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

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

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.