REST Resource: files

संसाधन: फ़ाइल

एपीआई पर अपलोड की गई फ़ाइल.

जेएसओएन के काेड में दिखाना
{
  "name": string,
  "displayName": string,
  "mimeType": string,
  "sizeBytes": string,
  "createTime": string,
  "updateTime": string,
  "expirationTime": string,
  "sha256Hash": string,
  "uri": string,
  "state": enum (State),
  "error": {
    object (Status)
  },

  // Union field metadata can be only one of the following:
  "videoMetadata": {
    object (VideoMetadata)
  }
  // End of list of possible types for union field metadata.
}
फ़ील्ड
name

string

इम्यूटेबल. आइडेंटिफ़ायर. File के संसाधन का नाम. आईडी ("फ़ाइलें/" प्रीफ़िक्स को छोड़कर) में 40 वर्ण हो सकते हैं, जो अंग्रेज़ी के छोटे अक्षर या डैश (-) हों. आईडी के शुरू या आखिर में डैश नहीं हो सकता. अगर नाम बनाने के बाद कोई नाम नहीं दिया जाता है, तो एक यूनीक नाम जनरेट कर दिया जाएगा. उदाहरण: files/123-456

displayName

string

ज़रूरी नहीं. File का डिसप्ले नेम, जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. डिसप्ले नेम में 512 से ज़्यादा वर्ण नहीं होने चाहिए. इसमें स्पेस भी शामिल हैं. उदाहरण: "वेलकम इमेज"

mimeType

string

सिर्फ़ आउटपुट के लिए. फ़ाइल का MIME प्रकार.

sizeBytes

string (int64 format)

सिर्फ़ आउटपुट के लिए. फ़ाइल का साइज़ बाइट में.

createTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. File को बनाए जाने के समय का टाइमस्टैंप.

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड का रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. File को आखिरी बार अपडेट किए जाने का टाइमस्टैंप.

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड का रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

expirationTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. File को मिटाए जाने का टाइमस्टैंप. सिर्फ़ तब सेट करें, जब File की समयसीमा खत्म होने वाली हो.

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड का रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

sha256Hash

string (bytes format)

सिर्फ़ आउटपुट के लिए. अपलोड की गई बाइट का SHA-256 हैश.

base64 कोड में बदली गई स्ट्रिंग.

uri

string

सिर्फ़ आउटपुट के लिए. File का यूआरआई.

state

enum (State)

सिर्फ़ आउटपुट के लिए. फ़ाइल की प्रोसेसिंग स्थिति.

error

object (Status)

सिर्फ़ आउटपुट के लिए. अगर फ़ाइल प्रोसेस नहीं हो सकी, तो गड़बड़ी का स्टेटस.

यूनियन फ़ील्ड metadata. फ़ाइल के लिए मेटाडेटा. metadata इनमें से सिर्फ़ एक हो सकती है:
videoMetadata

object (VideoMetadata)

सिर्फ़ आउटपुट के लिए. वीडियो का मेटाडेटा.

VideoMetadata

File वीडियो का मेटाडेटा.

जेएसओएन के काेड में दिखाना
{
  "videoDuration": string
}
फ़ील्ड
videoDuration

string (Duration format)

वीडियो की अवधि.

सेकंड में दी गई अवधि, जिसमें नौ भिन्नांक हो सकते हैं. साथ ही, यह 's' पर खत्म होता है. उदाहरण: "3.5s".

स्थिति

फ़ाइल के लाइफ़साइकल की जानकारी.

Enums
STATE_UNSPECIFIED डिफ़ॉल्ट वैल्यू. इस वैल्यू का इस्तेमाल तब किया जाता है, जब राज्य का पता न लगाया जाता हो.
PROCESSING फ़ाइल प्रोसेस की जा रही है. फ़िलहाल, इसका इस्तेमाल अनुमान के लिए नहीं किया जा सकता.
ACTIVE फ़ाइल प्रोसेस हो गई है और अनुमान के लिए उपलब्ध है.
FAILED फ़ाइल को प्रोसेस नहीं किया जा सका.

तरीके

delete

File को मिटाता है.

get

दिए गए File के लिए मेटाडेटा की जानकारी देता है.

list

यह डायलॉग बॉक्स, अनुरोध करने वाले प्रोजेक्ट के File के मेटाडेटा की सूची बनाता है.