ניהול בקשות לשינוי מוזיקה

הערה: ממשק YouTube Content ID API מיועד לשימוש של שותפי תוכן של YouTube, והוא אינו נגיש לכל המפתחים או לכל משתמשי YouTube. אם אינכם רואים את YouTube Content ID API כאחד מהשירותים המפורטים בGoogle API Console, מומלץ לעיין במרכז העזרה של YouTube כדי לקבל מידע נוסף על תוכנית השותפים של YouTube.

הערה: המידע במדריך הזה מתייחס באופן ספציפי לנכסי יצירה.

ב-YouTube Studio, אתם יכולים לבקש לבצע שינויים בנכסי המוזיקה שבבעלותכם. ניתן להשתמש בממשק ה-API של Content ID גם כדי:

• יצירת בקשות לשינויים
• רשימת הסטטוסים של בקשות שינוי

בדף הזה יש סקירה כללית של שיטות הבידינג MusicChangeRequest ב-Content ID API. מפורטות בו גם דוגמאות ליצירה ולרישום של בקשות לשינויים.

דרישות

אתם צריכים לקבל פרטי כניסה להרשאה כדי להשתמש ב-API הזה. עליך להשתמש באסימון ההרשאה שלך בבקשות.

אם אתם משתמשים ב-cURL, הקפידו ליצור משתנה AUTH_TOKEN לשימוש בפקודות האלה:

export AUTH_TOKEN="[YOUR_AUTH_TOKEN]"

יצירת בקשה לשינוי מוזיקה

אתם משתמשים בשיטה musicChangeRequests.create כדי לשנות פריט תוכן או מסלול הפצה. הבקשה צריכה לכלול משאב של בקשת שינוי שמציין את סוג השינוי שרוצים לבצע. לאחר מכן אפשר לציין את בקשות השינויים כדי לבדוק את הסטטוס שלהן.

סוגים של בקשות לשינויים

סוגי הבקשות החוקיים כוללים:

• misreconciledArtist: בקשה לשינוי האומן של פריט תוכן או טראק. לוקח משאב DesiredArtist. יש להשתמש באפשרות הזו אם היא לא משויכת לאומן הראשי או לאומן המוצג הרצוי.
• undesiredDiscography: בקשה לשנות את ערוץ האומן המשויך לפריט תוכן. יש להשתמש באפשרות הזו אם פריט תוכן של אומן אחר מופיע בצורה שגויה בערוץ של אומן אחר.
• incorrectPlayability: בקשה לשינוי יכולת ההפעלה של פריט תוכן או טראק. כדאי להשתמש באפשרות הזו אם לא ניתן להפעיל אותו או להציג אותו כצפוי במוצר.
• incorrectMusicVideo: בקשה לשינוי סרטון מוזיקה של טראק. לוקח משאב DesiredMusicVideo. ניתן להשתמש באפשרות הזו אם היא לא משויכת לסרטון המוזיקה הרצוי.
• incorrectMetadata: בקשה לשינוי האיות, הפורמט או התרגום של פריט תוכן או טראק.

דוגמה: פריט התוכן לא משויך לאומן הראשי או לאומן המוצג הרצוי

נניח ששלחתם פריט תוכן ל-YouTube Music, אבל פריט התוכן כולל אומן לא נכון. כדי לשלוח בקשה לשינוי הזה:

1. מוצאים ב-YouTube Studio את הגרסה המושפעת. מעתיקים את מספר המזהה (לדוגמה, קוד מוצר אוניברסלי (UPC)) מהדף של YouTube Studio.

2. צריך ליצור בקשה שמכילה את הצהרת ה-JSON הבאה:

   '{
     "release": "releases/0012345678901", 
     "misreconciledArtist": {
       "channelId": "UCP8W_Atlibtp488XGcRkPnQ", 
       "newArtist": "false", 
       "supplementalInfo": "Comment about the change"
     }
   }'
   

   • release הוא מספר המזהה של פריט התוכן, ואפשר למצוא אותו ב-YouTube Studio.
   • misreconciledArtist לוקח משאב desiredArtist שמורכב מהדברים הבאים:
     • channelId: מזהה הערוץ של האומן שאליו רוצים להעביר את פריט התוכן. כדי למצוא את מזהה הערוץ, נכנסים לערוץ של האומן ב-YouTube ומעתיקים את המזהה מכתובת ה-URL. אם האומן לא קיים והוא אומן חדש, משאירים את השדה channelId ריק ומסמנים את התיבה newArtist: true.
     • newArtist: אם האומן לא נמצא כרגע ב-YouTube Music, מסמנים את השדה הזה true. אחרת, אם ציינתם מזהה ערוץ, צריך לסמן את השדה הזה false.
     • supplementalInfo: הערות אופציונליות לגבי הבקשה.

3. כדי לשלוח את הבקשה, יש להשתמש בשיטה musicChangeRequests.create. יש לכלול את קובץ ה-JSON שמכיל את הבקשה. לדוגמה, הפקודה הבאה מראה איך שולחים את הבקשה הזו באמצעות cURL:

   curl -v -H "Authorization: Bearer $AUTH_TOKEN" --json '{"release": "releases/0012345678901", "misreconciledArtist": {"channelId": "UCP8W_Atlibtp488XGcRkPnQ", "newArtist": "false", "supplementalInfo": "Comment about the change"}}' https://www.googleapis.com/youtube/partner/v1/music/changeRequests
   

בקשות לשינוי רשימה

כדי לאחזר רשימה של בקשות לשינויי מוזיקה שדווחו, יש להשתמש בשיטה musicChangeRequests.list. השיטה מגיבה באמצעות רשימה של בקשות לשינויים, לאחר סינון לפי בעלי התוכן. אפשר גם לסנן את התוצאות לפי פריט תוכן או מעקב, ולפי בעל התוכן.

דוגמה: בקשות לשינוי רשימה של גרסה ספציפית

נניח שאתם צריכים לקבל אצל בעלי תוכן אחרים את בקשות השינוי בגרסה ספציפית. הפקודה הבאה היא דוגמה לאופן שבו שולחים את הבקשה באמצעות cURL:

curl -v -H "Authorization: Bearer $AUTH_TOKEN" https://www.googleapis.com/youtube/partner/v1/music/changeRequests?onBehalfOfContentOwner=91U_FgOL8S7d52aNESfMaw&filter.parent=releases/0999999999999

איפה:

• onBehalfOfContentOwner הוא מזהה הערוץ של בעלי התוכן שהם הבעלים של פריט התוכן או הטראק.
• filter מציין release/[RELEASE_ID_NUMBER] או track/[TRACK_ID_NUMBER].