البحث عن تصنيفات

يمكن أن يكون لدى مؤسستك تصنيفات متعددة، وتتضمّن التصنيفات حقولاً متعدّدة. توفر Google Drive Labels API المصدر labels لقراءة التصنيفات.

يوضّح هذا المستند كيفية البحث عن التصنيفات واستردادها باستخدام Drive Labels API.

الطُرق

يوفّر مصدر labels الطرق التالية لقراءة قيم التصنيفات، ولكل طريقة مهمة محدّدة:

النطاق الطريقة
تصنيف واحد حسب اسم المصدر labels.get
جميع التصنيفات labels.list

الحصول على تصنيف حسب اسم المصدر

للحصول على تصنيف واحد حسب اسم المصدر، استخدِم الـ get طريقة على الـ labels مصدر.

مطلوب name لمصدر التصنيف ويمكن أن يكون منظّمًا على النحو التالي:

  • 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
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 باسم التصنيف.

سرد جميع التصنيفات

للحصول على قائمة بالتصنيفات، استخدِم طريقة list على مصدر labels.

عليك أيضًا تحديد ما يلي:

  • مَعلمة طلب بحث 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 باسم العميل.