Method: files.listLabels

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

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

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

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

पाथ पैरामीटर

पैरामीटर
fileId

string

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

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

पैरामीटर
maxResults

integer

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

pageToken

string

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

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

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

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

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

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

JSON के काेड में दिखाना
{
  "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.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.readonly

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