किसी वीडियो का मेटाडेटा वापस पाएं

मान्य पते या वीडियो आईडी के लिए, lookupVideoMetadata तरीका, किसी वीडियो से जुड़ा मेटाडेटा दिखाता है. रिस्पॉन्स बॉडी में मौजूद मेटाडेटा की मदद से, यह पता लगाया जा सकता है कि इमेज कितनी नई है और वीडियो की अवधि कितनी है. साथ ही, वीडियो मौजूद होने की पुष्टि करने के लिए, यह एक मुफ़्त वर्कफ़्लो भी उपलब्ध कराता है.

एपीआई का इस्तेमाल कैसे करें

इस एंडपॉइंट को कॉल करने के लिए, इसे यूआरएल के कोड में बदला गया अमेरिका का डाक पता या videoId भेजें.

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=POSTAL_ADDRESS"

इसके बाद, एपीआई इन दोनों रिस्पॉन्स में से कोई एक रिस्पॉन्स भेजता है:

• अगर वीडियो मौजूद होता है, तो lookupVideoMetadata वीडियो का मेटाडेटा दिखाता है.
• अगर वीडियो मौजूद नहीं है, तो एपीआई 404 गड़बड़ी कोड दिखाता है.

अनुरोध का उदाहरण

यहां दिया गया कोड सैंपल, ट्रांसअमेरिका पिरामिड के हवाई व्यू का अनुरोध करता है. यह पिरामिड, 600 मॉन्टगोमरी स्ट्रीट, सैन फ़्रांसिस्को, CA 94111 में है.

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=600%20Montgomery%20St%2C%20San%20Francisco%2C%20CA%2094111"

जवाब का उदाहरण

यहां दिए गए JSON के उदाहरणों में, lookupVideoMetadata अनुरोध के सभी संभावित जवाब दिखाए गए हैं.

वीडियो मिला

वीडियो पहले ही रेंडर हो चुका है.

{
  "videoId": "Ul1naoFmqo69U1zUVrQRkc",
  "captureDate": {
    "year": 2022,
    "month": 4,
    "day": 1
  },
  "duration": "40s",
  "state": "ACTIVE"
}

वीडियो रेंडर हो रहा है

वीडियो को रेंडर किया जा रहा है.

{
  "videoId": "Ul1naoFmqo69U1zUVrQRkc",
  "state": "PROCESSING"
}

वीडियो नहीं मिला

वीडियो, Google के डेटाबेस में मौजूद नहीं है. ऐसा इसलिए हो सकता है, क्योंकि इसे अब तक रेंडर नहीं किया गया है या जगह ऐसी है जहां यह सुविधा काम नहीं करती.

अगर आपका कारोबार इस सुविधा के लिए उपलब्ध जगह पर है, तो रेंडर करने का अनुरोध करने के लिए, renderVideo का इस्तेमाल करें.

{
  "error": {
    "code": 404,
    "message": "Video not found.",
    "status": "NOT_FOUND"
  }
}