لیست برچسب ها
درخواست HTTP
GET https://drivelabels.googleapis.com/v2/labels
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای پرس و جو
مولفه های | |
---|---|
publishedOnly | آیا فقط برچسب های منتشر شده در نتایج گنجانده شود یا خیر.
|
customer | مشتری به محدوده این لیست درخواست. به عنوان مثال: "customers/abcd1234". اگر تنظیم نشود، همه برچسبها را در مشتری فعلی برمیگرداند. |
languageCode | کد زبان BCP-47 که برای ارزیابی برچسبهای فیلد محلی استفاده میشود. وقتی مشخص نیست، از مقادیر در زبان پیکربندی پیشفرض استفاده میشود. |
pageSize | حداکثر تعداد برچسب برای بازگشت در هر صفحه. پیش فرض: 50. حداکثر: 200. |
pageToken | نشانه صفحه برای بازگشت. |
view | در صورت مشخص شدن، فقط فیلدهای خاصی که به نمای مشخص شده تعلق دارند برگردانده می شوند. |
| |
useAdminAccess | برای استفاده از اعتبارنامه مدیریت کاربر، روی |
minimumRole | سطح دسترسی کاربر را در برچسب های برگشتی مشخص می کند. حداقل نقشی که یک کاربر باید روی یک برچسب داشته باشد. پیشفرض |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
پاسخ برای لیست کردن برچسب ها.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"labels": [
{
object ( |
زمینه های | |
---|---|
labels[] | برچسب ها. |
nextPageToken | نشانه صفحه بعد در پاسخ. |
محدوده مجوز
به یکی از حوزه های 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
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.