Method: labels.get

یک برچسب با نام منبع آن دریافت کنید. برای اطلاعات بیشتر، به جستجوی برچسب ها مراجعه کنید.

نام منبع ممکن است یکی از موارد زیر باشد:

  • labels/{id} - labels/{id}@latest ببینید
  • labels/{id}@latest - آخرین ویرایش برچسب را دریافت می‌کند.
  • labels/{id}@published - ویرایش منتشر شده فعلی برچسب را دریافت می‌کند.
  • labels/{id}@{revisionId} - برچسب را در شناسه بازبینی مشخص شده دریافت می‌کند.

درخواست HTTP

GET https://drivelabels.googleapis.com/v2/{name=labels/*}

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
name

string

مورد نیاز. نام منبع برچسب.

ممکن است هر یک از:

  • labels/{id} (معادل labels/{id}@latest)
  • labels/{id}@latest
  • labels/{id}@published
  • labels/{id}@{revisionId}

پارامترهای پرس و جو

پارامترها
useAdminAccess

boolean

برای استفاده از اعتبارنامه مدیریت کاربر، روی true تنظیم کنید. سرور قبل از اجازه دسترسی، تأیید می کند که کاربر مدیر برچسب است.

languageCode

string

کد زبان BCP-47 که برای ارزیابی برچسب‌های فیلد محلی استفاده می‌شود. وقتی مشخص نیست، از مقادیر در زبان پیکربندی پیش‌فرض استفاده می‌شود.

view

enum ( LabelView )

در صورت مشخص شدن، فقط فیلدهای خاصی که به نمای مشخص شده تعلق دارند برگردانده می شوند.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Label است.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/drive.labels
  • https://www.googleapis.com/auth/drive.labels.readonly
  • https://www.googleapis.com/auth/drive.admin.labels
  • https://www.googleapis.com/auth/drive.admin.labels.readonly

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.