आपके संगठन में एक से ज़्यादा लेबल हो सकते हैं, जिनमें कई फ़ील्ड वाले लेबल होंगे.
लेबल पढ़ने की सुविधा चालू करने के लिए, Labels API
labels
कलेक्शन
उपलब्ध कराता है.
इस पेज पर लेबल खोजने और उन्हें वापस पाने का तरीका बताया गया है.
तरीके
labels
कलेक्शन में, लेबल की वैल्यू पढ़ने के ये तरीके बताए गए हैं. हर एक के लिए खास टास्क को ध्यान में रखा गया है:
रेंज | टेक्स्ट पढ़े जाने से जुड़े कंट्रोल |
---|---|
संसाधन के नाम के हिसाब से एक लेबल | labels.get |
सभी लेबल | labels.list |
संसाधन के नाम के हिसाब से लेबल पाएं
किसी एक लेबल को उसके रिसॉर्स के नाम के आधार पर पाने के लिए, labels.get
तरीके का इस्तेमाल करें.
लेबल रिसॉर्स का नाम ज़रूरी है. इसे इस तरह से बनाया जा सकता है:
labels/{id}
याlabels/{id}@latest
—लेबल में सबसे नए बदलाव किए जाते हैं.labels/{id}@published
—इससे पब्लिश किए गए मौजूदा लेबल में बदलाव किए जा सकते हैं.labels/{id}@{revisionId}
—तय किए गए बदलाव आईडी पर लेबल पाता है.
आपको यह भी बताना होगा:
- लेबल रिस्पॉन्स पर लागू होने वाले रिसॉर्स व्यू को सेट करने के लिए,
LabelView
LABEL_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
सेट नहीं है, तो मौजूदा ग्राहक के सभी लेबल वापस भेज दिए जाते हैं.लेबल रिस्पॉन्स पर लागू होने वाले रिसॉर्स व्यू को सेट करने के लिए,
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');
}
});