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

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