लेबल खोजना

आपके संगठन में कई लेबल हो सकते हैं. साथ ही, लेबल में कई फ़ील्ड हो सकते हैं. Google Drive Labels API, लेबल पढ़ने की सुविधा चालू करने के लिए labels संसाधन उपलब्ध कराता है.

इस दस्तावेज़ में, Drive Labels API का इस्तेमाल करके लेबल खोजने और उन्हें वापस पाने का तरीका बताया गया है.

तरीके

labels संसाधन, लेबल की वैल्यू पढ़ने के लिए ये तरीके उपलब्ध कराता है. हर तरीके का इस्तेमाल किसी खास काम के लिए किया जाता है:

रेंज तरीका
संसाधन के नाम के हिसाब से एक लेबल labels.get
सभी लेबल labels.list

संसाधन के नाम के हिसाब से लेबल पाना

किसी लेबल को उसके संसाधन के नाम के हिसाब से पाने के लिए, labels संसाधन पर get तरीके का इस्तेमाल करें.

लेबल संसाधन name ज़रूरी है और इसे इस तरह से स्ट्रक्चर किया जा सकता है:

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

लेबल के जवाबों पर लागू होने वाला संसाधन व्यू सेट करने के लिए, आपको LABEL_VIEW_FULL के तौर पर LabelView ऑब्जेक्ट तय करना होगा. LABEL_VIEW_FULL सभी संभावित फ़ील्ड दिखाता है.

यहां दिए गए कोड सैंपल में, लेबल के name का इस्तेमाल करके, संसाधन के नाम के हिसाब से एक लेबल पाने का तरीका बताया गया है:

Python

# Label name, with or without revision:
#
# Revision specified:
# labels/LABEL_ID@published
# labels/LABEL_ID@latest
# labels/LABEL_ID@1
#
# No revision specified, returns latest revision:
# labels/LABEL_ID
name = 'labels/NAME@published'

# Label view controls level of data in response
view = 'LABEL_VIEW_FULL'

label = service.labels().get(
    name=name,
    view=view
).execute()

Node.js

// Label name, with or without revision:
//
// Revision specified:
// labels/LABEL_ID@published
// labels/LABEL_ID@latest
// labels/LABEL_ID@1
//
// No revision specified, returns latest revision:
// labels/LABEL_ID
const name = 'labels/NAME@published';

// Label view controls level of data in response
const view = 'LABEL_VIEW_FULL';

service.labels.get({
  name: name,
  view: view
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

NAME की जगह लेबल का नाम डालें.

सभी लेबल की सूची बनाना

लेबल की सूची पाने के लिए, labels संसाधन पर list तरीके का इस्तेमाल करें.

आपको यह भी बताना होगा कि:

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

  • LabelView ऑब्जेक्ट को LABEL_VIEW_FULL के तौर पर इस्तेमाल करके, संसाधन का ऐसा व्यू सेट करें जो लेबल वाले जवाबों पर लागू होता है. LABEL_VIEW_FULL सभी संभावित फ़ील्ड दिखाता है.

यहां दिए गए कोड सैंपल में, लेबल की सूची पाने के लिए customer क्वेरी पैरामीटर का इस्तेमाल करने का तरीका बताया गया है:

Python

response = service.labels().list(
    customer='customers/CUSTOMER',
    view='LABEL_VIEW_FULL'
).execute()

Node.js

const params = {
  customer: 'customers/CUSTOMER',
  view: 'LABEL_VIEW_FULL'
};

service.labels.list(params, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  const labels = res.data.labels;
  if (labels) {
    labels.forEach((label) => {
      const name = label.name;
      const title = label.properties.title;
      console.log(`${name}\t${title}`);
    });
  } else {
    console.log('No Labels');
  }
});

CUSTOMER की जगह ग्राहक का नाम डालें.