Videos: batchGetStats

यह एपीआई अनुरोध के पैरामीटर से मेल खाने वाले वीडियो के आंकड़ों की सूची वापस लाता है.

कोटा पर असर: इस तरीके को कॉल करने पर, कोटा की लागत 1 यूनिट होती है.

अनुरोध

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

GET https://www.googleapis.com/youtube/v3/videos:batchGetStats

अनुमति देना

गैर-सार्वजनिक वीडियो के लिए, इस तरीके का इस्तेमाल करने से पहले पुष्टि करना ज़रूरी है. हालांकि, सार्वजनिक वीडियो के लिए ऐसा करना ज़रूरी नहीं है. अगर अनुमति दी जाती है, तो अनुरोध को इनमें से कम से कम एक स्कोप के साथ अनुमति दी जानी चाहिए (पुष्टि और अनुमति के बारे में ज़्यादा जानें).

दायरा
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtube.readonly

पैरामीटर

यहां दी गई टेबल में, उन पैरामीटर की सूची दी गई है जिनका इस्तेमाल इस क्वेरी में किया जा सकता है. सूची में दिए गए सभी पैरामीटर, क्वेरी पैरामीटर हैं.

पैरामीटर
ज़रूरी पैरामीटर
id string
id पैरामीटर, उन संसाधनों के लिए YouTube वीडियो आईडी की कॉमा लगाकर अलग की गई सूची तय करता है जिन्हें वापस पाया जा रहा है. videoStat संसाधन में, id प्रॉपर्टी वीडियो का आईडी तय करती है.
part string
part पैरामीटर, videoStat संसाधन की एक या उससे ज़्यादा प्रॉपर्टी की कॉमा लगाकर अलग की गई सूची के बारे में बताता है. एपीआई रिस्पॉन्स में यह सूची शामिल होगी.

यहां दी गई सूची में, part के वे नाम शामिल हैं जिन्हें पैरामीटर की वैल्यू में शामिल किया जा सकता है:
  • contentDetails
  • id
  • snippet
  • statistics
वैकल्पिक पैरामीटर
onBehalfOfContentOwner string
इस पैरामीटर का इस्तेमाल सिर्फ़ अनुमति वाले अनुरोध में किया जा सकता है. ध्यान दें: यह पैरामीटर सिर्फ़ YouTube कॉन्टेंट पार्टनर के लिए है.

onBehalfOfContentOwner पैरामीटर से पता चलता है कि अनुरोध की पुष्टि करने वाले क्रेडेंशियल, YouTube सीएमएस के ऐसे उपयोगकर्ता की पहचान करते हैं जो पैरामीटर वैल्यू में बताए गए कॉन्टेंट के मालिक की ओर से कार्रवाई कर रहा है. यह पैरामीटर, YouTube के उन कॉन्टेंट पार्टनर के लिए है जिनके पास कई YouTube चैनलों का मालिकाना हक है और वे उन्हें मैनेज करते हैं. इससे कॉन्टेंट के मालिकों को एक बार पुष्टि करने की सुविधा मिलती है. इसके बाद, वे अपने सभी वीडियो और चैनल का डेटा ऐक्सेस कर सकते हैं. इसके लिए, उन्हें हर चैनल के लिए पुष्टि करने वाले क्रेडेंशियल देने की ज़रूरत नहीं होती. उपयोगकर्ता जिस CMS खाते से पुष्टि करता है वह, YouTube पर कॉन्टेंट के मालिकाना हक वाले उस खाते से लिंक होना चाहिए जिसे आपने चुना है.

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

इस तरीके को कॉल करते समय, अनुरोध का मुख्य हिस्सा न दें.

जवाब

अगर अनुरोध सही से काम करता है, तो यह तरीका जवाब के मुख्य हिस्से में नीचे दिया गया स्ट्रक्चर दिखाता है:

{
  "kind": "youtube#batchGetStatsResponse",
  "etag": etag,
  "items": [
    {
      "kind": "youtube#videoStats",
      "etag": etag,
      "id": string,
      "snippet": {
        "publishTime": datetime
      },
      "statistics": {
        "viewCount": unsigned long,
        "likeCount": unsigned long,
        "commentCount": unsigned long
      },
      "contentDetails": {
        "duration": string,
        "durationMillis": unsigned long
      }
    }
  ],
  "summary": {
    "requestedVideoCount": unsigned long,
    "succeededVideoCount": unsigned long,
    "failedVideoCount": unsigned long,
    "failedVideoIds": [
      string
    ]
  }
}

प्रॉपर्टी

यहां दी गई टेबल में, इस संसाधन में दिखने वाली प्रॉपर्टी के बारे में बताया गया है:

प्रॉपर्टी
kind string
इससे एपीआई संसाधन के टाइप की पहचान होती है. वैल्यू youtube#batchGetStatsResponse होगी.
etag etag
इस संसाधन का ETag.
items[] list
वीडियो के आंकड़ों की ऐसी सूची जो अनुरोध की शर्तों से मेल खाती हो.
items[].id string
यह आईडी, YouTube पर वीडियो की पहचान करने के लिए इस्तेमाल किया जाता है.
items[].snippet.publishTime datetime
वीडियो अपलोड करने की तारीख और समय.
items[].statistics.viewCount unsigned long
इससे पता चलता है कि वीडियो को कितनी बार देखा गया.
items[].statistics.likeCount unsigned long
उन उपयोगकर्ताओं की संख्या जिन्होंने वीडियो को पसंद किया है.
items[].statistics.commentCount unsigned long
वीडियो पर की गई टिप्पणियों की संख्या.
items[].contentDetails.duration string
वीडियो की अवधि.
items[].contentDetails.durationMillis unsigned long
वीडियो की अवधि, मिलीसेकंड में.
summary object
batchGetStats अनुरोध की खास जानकारी.
summary.requestedVideoCount unsigned long
अनुरोध किए गए वीडियो की संख्या.
summary.succeededVideoCount unsigned long
सफल हुए वीडियो की संख्या.
summary.failedVideoCount unsigned long
उन वीडियो की संख्या जिन्हें प्रोसेस नहीं किया जा सका.
summary.failedVideoIds[] list
वे वीडियो आईडी जो अपलोड नहीं हो सके.

गड़बड़ियां

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