Method: labels.get

लेबल को उसके संसाधन के नाम से पाएं. ज़्यादा जानकारी के लिए, लेबल खोजना लेख पढ़ें.

संसाधन का नाम इनमें से कोई भी हो सकता है:

  • labels/{id} - labels/{id}@latest देखें
  • labels/{id}@latest - इससे लेबल का सबसे नया वर्शन मिलता है.
  • labels/{id}@published - इस फ़ंक्शन की मदद से, लेबल के पब्लिश किए गए मौजूदा वर्शन की जानकारी मिलती है.
  • labels/{id}@{revisionId} - इससे, तय किए गए रीविज़न आईडी पर मौजूद लेबल मिलता है.

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

GET https://drivelabels.googleapis.com/v2/{name=labels/*}

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

पाथ पैरामीटर

पैरामीटर
name

string

ज़रूरी है. लेबल के संसाधन का नाम.

इनमें से कोई भी हो सकता है:

  • labels/{id} (labels/{id}@latest के बराबर)
  • labels/{id}@latest
  • labels/{id}@published
  • labels/{id}@{revisionId}

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

पैरामीटर
useAdminAccess

boolean

उपयोगकर्ता के एडमिन क्रेडेंशियल का इस्तेमाल करने के लिए, इसे true पर सेट करें. सर्वर यह पुष्टि करता है कि उपयोगकर्ता, लेबल का एडमिन है. इसके बाद ही, उसे ऐक्सेस करने की अनुमति दी जाती है.
languageCode

string

स्थानीय भाषा में फ़ील्ड के लेबल का आकलन करने के लिए, BCP-47 भाषा कोड का इस्तेमाल करें. अगर इस एट्रिब्यूट की वैल्यू नहीं दी जाती है, तो कॉन्फ़िगर की गई डिफ़ॉल्ट भाषा में मौजूद वैल्यू का इस्तेमाल किया जाता है.
view

enum (LabelView)

अगर ऐसा किया जाता है, तो सिर्फ़ बताए गए व्यू से जुड़े कुछ फ़ील्ड दिखाए जाते हैं.

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

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

जवाब का मुख्य हिस्सा

कामयाब रहने पर, जवाब के मुख्य हिस्से में Label का एक इंस्टेंस शामिल किया जाता है.

अनुमति के स्कोप

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

  • https://www.googleapis.com/auth/drive.labels
  • https://www.googleapis.com/auth/drive.labels.readonly
  • https://www.googleapis.com/auth/drive.admin.labels
  • https://www.googleapis.com/auth/drive.admin.labels.readonly

ज़्यादा जानकारी के लिए, अनुमति पाने से जुड़ी गाइड देखें.