Method: ownershipHistory.list

किसी ऐसेट के मालिकाना हक के डेटा की सूची दिखाता है. भले ही, डेटा किसी भी कॉन्टेंट के मालिक ने दिया हो. इस सूची में, हर कॉन्टेंट के मालिक के लिए मालिकाना हक का सिर्फ़ सबसे हाल का डेटा शामिल होता है. हालांकि, अगर कॉन्टेंट के मालिक ने कई डेटा सोर्स (एपीआई, कॉन्टेंट फ़ीड वगैरह) के ज़रिए मालिकाना हक का डेटा सबमिट किया है, तो सूची में हर कॉन्टेंट के मालिक और डेटा सोर्स का सबसे नया डेटा शामिल होगा.

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

GET https://youtubepartner.googleapis.com/youtube/partner/v1/ownershipHistory

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

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

पैरामीटर
assetId

string

assetId पैरामीटर, उस ऐसेट का YouTube ऐसेट आईडी बताता है जिसके मालिकाना हक के डेटा का इतिहास आपको चाहिए.
onBehalfOfContentOwner

string

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

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

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

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

किसी ऐसेट से जुड़े ownershipHistory संसाधनों की सूची.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना 
{
  "kind": string,
  "items": [
    {
      object (RightsOwnershipHistory)
    }
  ]
}
फ़ील्ड
kind

string

एपीआई से मिले रिस्पॉन्स का टाइप. इस ऑपरेशन के लिए, वैल्यू youtubePartner#ownershipHistoryList है.
items[]

object (RightsOwnershipHistory)

अनुरोध की शर्तों से मेल खाने वाले, मालिकाना हक के इतिहास (youtubePartner#ownershipHistory) वाले संसाधनों की सूची.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

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