จัดการคำขอเปลี่ยนแปลงเพลง

หมายเหตุ: Content ID API ของ YouTube มีไว้เพื่อการใช้งานโดยพาร์ทเนอร์เนื้อหาของ YouTube และนักพัฒนาซอฟต์แวร์บางรายหรือผู้ใช้ YouTube บางส่วนอาจเข้าถึงไม่ได้ หากคุณไม่เห็น API ของ Content ID ของ YouTube เป็นหนึ่งในบริการที่ระบุไว้ในคอนโซล Google API โปรดดูศูนย์ช่วยเหลือของ YouTube เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับโปรแกรมพาร์ทเนอร์ YouTube

ข้อกำหนด

หากคุณใช้ 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]