लेबल खोजना

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

इस पेज पर लेबल खोजने और उन्हें वापस पाने का तरीका बताया गया है.

तरीके

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

रेंज	टेक्स्ट पढ़े जाने से जुड़े कंट्रोल
संसाधन के नाम के हिसाब से एक लेबल	labels.get
सभी लेबल	labels.list

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

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

लेबल रिसॉर्स का नाम ज़रूरी है. इसे इस तरह से बनाया जा सकता है:

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

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

• लेबल रिस्पॉन्स पर लागू होने वाले रिसॉर्स व्यू को सेट करने के लिए, LabelViewLABEL_VIEW_FULL है. 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

name = "labels/NAME@published"

# Label view controls level of data in response
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);
});

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

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

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

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

• लेबल रिस्पॉन्स पर लागू होने वाले रिसॉर्स व्यू को सेट करने के लिए, LabelViewLABEL_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');
  }
});

ध्यान दें: अगर आपको सिर्फ़ पब्लिश किए गए लेबल के बदलाव वापस करने हैं, तो यह भी बताया जा सकता है कि publishedOnly क्या है true. नतीजों में, बंद किए गए लेबल भी शामिल हैं.