Etiket arayın

Kuruluşunuzun birden fazla etiketi olabilir ve etiketlerde çeşitli alanlar bulunabilir. Google Drive Labels API, etiketlerin okunmasını sağlamak için labels kaynağını sağlar.

Bu belgede, Drive Labels API kullanılarak etiketlerin nasıl aranacağı ve alınacağı açıklanmaktadır.

Yöntemler

labels kaynağı, etiket değerlerini okumak için aşağıdaki yöntemleri sağlar. Her yöntemin belirli bir görevi vardır:

Kaynak adına göre etiket alma

Tek bir etiketi kaynak adına göre almak için labels kaynağında get yöntemini kullanın.

Bir etiket kaynağı name gereklidir ve şu şekilde yapılandırılabilir:

• labels/{id} veya labels/{id}@latest: En son etiket düzeltmesini alır.
• labels/{id}@published: Yayınlanan etiketin geçerli düzeltmesini alır.
• labels/{id}@{revisionId}: Belirtilen düzeltme kimliğindeki etiketi alır.

Etiket yanıtlarına uygulanan bir kaynak görünümü ayarlamak için LabelView nesnesini LABEL_VIEW_FULL olarak belirtmeniz gerekir. LABEL_VIEW_FULL, olası tüm alanları döndürür.

Aşağıdaki kod örneğinde, etiketin name yöntemini kullanarak kaynak adına göre tek bir etiketin nasıl alınacağı gösterilmektedir:

# 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()

// 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 yerine etiketin adını yazın.

Tüm etiketleri listeleme

Etiketlerin listesini almak için labels kaynağında list yöntemini kullanın.

Ayrıca şunları da belirtmeniz gerekir:

• Bu liste isteğinin kapsamını belirlemek için kullanılan customer sorgu parametresi. customer ayarlanmamışsa mevcut müşterideki tüm etiketler döndürülür.

• Etiket yanıtlarına uygulanan bir kaynak görünümü ayarlamak için LabelView nesnesi olarak LABEL_VIEW_FULL. LABEL_VIEW_FULL, olası tüm alanları döndürür.

Aşağıdaki kod örneğinde, etiket listesi almak için customer sorgu parametresinin nasıl kullanılacağı gösterilmektedir:

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

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 yerine müşterinin adını yazın.