Method: files.listLabels

यह किसी फ़ाइल के लेबल की सूची बनाता है.

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

GET https://www.googleapis.com/drive/v3/files/{fileId}/listLabels

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

पाथ के पैरामीटर

पैरामीटर
fileId

string

फ़ाइल का आईडी.

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

पैरामीटर
maxResults

integer

हर पेज पर लौटाए जाने वाले लेबल की ज़्यादा से ज़्यादा संख्या. यह वैल्यू सेट न होने पर, डिफ़ॉल्ट वैल्यू 100 होती है.
pageToken

string

अगले पेज पर सूची के पिछले अनुरोध को जारी रखने के लिए टोकन. इसे पिछले जवाब के 'nextPageToken' की वैल्यू पर सेट किया जाना चाहिए.

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

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

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

फ़ाइल पर लागू किए गए लेबल की सूची.

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

जेएसओएन के काेड में दिखाना 
{
  "labels": [
    {
      object (Label)
    }
  ],
  "nextPageToken": string,
  "kind": string
}
फ़ील्ड
labels[]

object (Label)

लेबल की सूची.
nextPageToken

string

लेबल के अगले पेज के लिए पेज टोकन. अगर सूची का अंत आ चुका है, तो यह फ़ील्ड नहीं दिखेगा. अगर किसी वजह से टोकन अस्वीकार किया जाता है, तो उसे खारिज कर देना चाहिए. साथ ही, नतीजों के पहले पेज से ही पेज नंबर को फिर से शुरू करना चाहिए. पेज टोकन आम तौर पर कुछ घंटों के लिए मान्य रहता है. हालांकि, अगर नए आइटम जोड़े या हटाए जाते हैं, तो आपको अलग नतीजे मिल सकते हैं.
kind

string

यह drive#labelList हमेशा होता है

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

इनमें से कोई एक OAuth स्कोप ज़रूरी है:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.readonly

कुछ दायरे सीमित हैं. इनका इस्तेमाल करने के लिए, सुरक्षा जांच की ज़रूरत होती है. ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.