Method: references.insert

इनमें से किसी एक तरीके से रेफ़रंस बनाता है:

  • अगर आपके अनुरोध में रेफ़रंस फ़ाइल अपलोड करने की बात कही गई है, तो YouTube, दिए गए कॉन्टेंट से रेफ़रंस फ़ाइल बनाता है. आपके पास वीडियो/ऑडियो फ़ाइल या पहले से जनरेट किया गया फ़िंगरप्रिंट देने का विकल्प होता है. अगर आपको पहले से जनरेट किया गया फ़िंगरप्रिंट देना है, तो अनुरोध के मुख्य हिस्से में reference संसाधन की fpDirect प्रॉपर्टी को true पर सेट करें. इस फ़्लो में, रेफ़रंस कॉन्टेंट देने के लिए, मल्टीपार्ट या फिर से शुरू किए जा सकने वाले अपलोड फ़्लो का इस्तेमाल किया जा सकता है.
  • अगर आपको दावा किए गए वीडियो का इस्तेमाल करके पहचान फ़ाइल बनानी है, तो दावे की पहचान करने के लिए claimId पैरामीटर का इस्तेमाल करें.

एचटीटीपी अनुरोध

  • मीडिया अपलोड करने के अनुरोधों के लिए, अपलोड यूआरआई:
    POST https://youtubepartner.googleapis.com/upload/youtube/partner/v1/references
  • सिर्फ़ मेटाडेटा के अनुरोधों के लिए मेटाडेटा यूआरआई:
    POST https://youtubepartner.googleapis.com/youtube/partner/v1/references

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

क्वेरी पैरामीटर

पैरामीटर
claimId

string

claimId पैरामीटर, किसी मौजूदा दावे का YouTube दावा आईडी तय करता है. इस आईडी से, पहचान वीडियो बनाया जाना चाहिए. (दावे वाले वीडियो को रेफ़रंस कॉन्टेंट के तौर पर इस्तेमाल किया जाता है.)
onBehalfOfContentOwner

string

onBehalfOfContentOwner पैरामीटर, उस कॉन्टेंट के मालिक की पहचान करता है जिसकी ओर से उपयोगकर्ता कार्रवाई कर रहा है. यह पैरामीटर उन उपयोगकर्ताओं के लिए है जिनके खाते, कॉन्टेंट के एक से ज़्यादा मालिकों से जुड़े हैं.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य भाग में Reference का उदाहरण है.

जवाब का मुख्य भाग

कामयाब रहने पर, जवाब के मुख्य हिस्से में Reference का एक इंस्टेंस शामिल किया जाता है.

अनुमति पाने के लिंक

नीचे दिए गए OAuth अनुमति की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 Overview देखें.