संगीत बदलने के अनुरोध मैनेज करें

ध्यान दें: YouTube Content ID API को YouTube के कॉन्टेंट पार्टनर के लिए बनाया गया है. इसे सभी डेवलपर या YouTube का इस्तेमाल करने वाले सभी लोग ऐक्सेस नहीं कर सकते. अगर आपको Google API Console में दी गई सेवाओं में से एक के तौर पर YouTube Content ID API नहीं दिख रहा है, तो YouTube Partner Program के बारे में ज़्यादा जानने के लिए, YouTube सहायता केंद्र पर जाएं.

ज़रूरी शर्तें

अगर आप cURL का इस्तेमाल कर रहे हैं, तो उन निर्देशों में इस्तेमाल करने के लिए एक AUTH_TOKEN वैरिएबल बनाना न भूलें:

export AUTH_TOKEN="[YOUR_AUTH_TOKEN]"

संगीत बदलने का अनुरोध करें

किसी रिलीज़ या ट्रैक को बदलने के लिए, musicChangeRequests.create तरीके का इस्तेमाल किया जाता है. आपके अनुरोध में बदलाव के अनुरोध का संसाधन शामिल होना चाहिए. यह संसाधन बताता है कि आपको किस तरह का बदलाव करना है. इसके बाद, बदलाव के अनुरोधों की सूची बनाकर उनकी स्थिति देखी जा सकती है.

बदलाव के अनुरोध किस तरह के हैं

मान्य अनुरोध के टाइप में ये शामिल हैं:

• misreconciledArtist: किसी रिलीज़ या ट्रैक के लिए, कलाकार बदलने का अनुरोध करना. DesiredArtist संसाधन लेता है. इस विकल्प का इस्तेमाल तब करें, जब यह पसंदीदा कलाकार या खास तौर पर दिखाए गए कलाकार से जुड़ा न हो.
• undesiredDiscography: किसी रिलीज़ से जुड़े कलाकार चैनल को बदलने का अनुरोध करें. इस विकल्प का इस्तेमाल तब करें, जब कलाकार के चैनल पर किसी दूसरे कलाकार की रिलीज़, गलती से दिख रही हो.
• incorrectPlayability: किसी रिलीज़ या ट्रैक के चलने की क्षमता में बदलाव करने का अनुरोध करें. इस विकल्प का इस्तेमाल तब करें, जब प्रॉडक्ट में यह उम्मीद के मुताबिक न चल रहा हो या दिख नहीं रहा हो.
• incorrectMusicVideo: किसी ट्रैक का संगीत वीडियो बदलने का अनुरोध. DesiredMusicVideo संसाधन लेता है. इस विकल्प का इस्तेमाल तब करें, जब यह मनचाहे संगीत वीडियो से जुड़ा न हो.
• incorrectMetadata: किसी रिलीज़ या ट्रैक की स्पेलिंग, फ़ॉर्मैटिंग या अनुवाद में बदलाव का अनुरोध करें.

उदाहरण: रिलीज़, मनचाहे मुख्य या खास कलाकार से जुड़ी हुई नहीं है

मान लें कि आपने YouTube Music पर किसी रिलीज़ को सबमिट किया है, लेकिन उसमें कोई गलत कलाकार जुड़ा है. इस बदलाव का अनुरोध करने के लिए:

1. YouTube Studio में उस रिलीज़ का पता लगाएं जिस पर असर पड़ा है. 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 पर कलाकार के चैनल पर जाएं और यूआरएल से आईडी को कॉपी करें. अगर कलाकार मौजूद नहीं है और वह एक नया कलाकार है, तो 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] के बारे में बताता है.