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 כתובה בתחביר של gRPC Transcoding.

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

פרמטרים
claimId

string

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

onBehalfOfContentOwner

string

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאות

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

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.