دامنه های API برچسب های Google Drive را انتخاب کنید

این سند حاوی اطلاعات مربوط به مجوز و احراز هویت مختص Drive Labels API است. قبل از مطالعه این سند، حتماً اطلاعات عمومی احراز هویت و مجوز Google Workspace را در بخش «درباره احراز هویت و مجوز بیشتر بدانید» مطالعه کنید.

پیکربندی OAuth 2.0 برای احراز هویت

صفحه رضایت OAuth را پیکربندی کنید و محدوده‌هایی را برای تعریف اطلاعات نمایش داده شده به کاربران و بررسی‌کنندگان برنامه انتخاب کنید و برنامه خود را ثبت کنید تا بتوانید بعداً آن را منتشر کنید.

دامنه‌های API برچسب‌های گوگل درایو

برای تعریف سطح دسترسی اعطا شده به برنامه خود، باید حوزه‌های مجوز را شناسایی و اعلام کنید. حوزه مجوز، یک رشته URI از نوع OAuth 2.0 است که شامل نام برنامه Google Workspace، نوع داده‌هایی که به آنها دسترسی دارد و سطح دسترسی است. حوزه‌ها، درخواست‌های برنامه شما برای کار با داده‌های Google Workspace، از جمله داده‌های حساب Google کاربران، هستند.

وقتی برنامه شما نصب می‌شود، از کاربر خواسته می‌شود تا محدوده‌های مورد استفاده برنامه را اعتبارسنجی کند. به طور کلی، شما باید محدوده‌ای را انتخاب کنید که بیشترین تمرکز را داشته باشد و از درخواست محدوده‌هایی که برنامه شما به آنها نیاز ندارد، خودداری کنید. کاربران راحت‌تر به محدوده‌های محدود و واضح دسترسی می‌دهند.

در صورت امکان، توصیه می‌کنیم از محدوده‌های غیرحساس استفاده کنید زیرا محدوده دسترسی به ازای هر فایل را اعطا می‌کند و دسترسی را به عملکردهای خاص مورد نیاز یک برنامه محدود می‌کند.

از دامنه‌های OAuth 2.0 زیر می‌توان برای خواندن، جستجو و تغییر برچسب‌های متادیتای اعمال‌شده روی آیتم‌های Drive استفاده کرد:

دامنه معنی
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
 خواندن، جستجو و اصلاح فراداده‌های برچسب اعمال شده روی موارد Drive.
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive.metadata.readonly
 فراداده‌های برچسب اعمال‌شده روی موارد Drive که برای برنامه مجاز هستند را بخوانید و جستجو کنید.

برای اطلاعات بیشتر، به حوزه‌های OAuth 2.0 در Drive API و مجوزدهی مختص Drive API مراجعه کنید.

محدوده‌های برچسب‌گذاری

از حوزه‌های OAuth زیر می‌توان برای مشاهده و مدیریت برچسب‌ها استفاده کرد:

دامنه معنی
https://www.googleapis.com/auth/drive.labels مشاهده، استفاده و مدیریت برچسب‌های Drive.
  • این دامنه اجازه دسترسی کاربر را می‌دهد و برای عملیات نوشتن در زمانی که use_admin_access تنظیم نشده باشد، مورد نیاز است.
  • عملیات نوشتن با این دامنه برای برچسب‌هایی با نوع برچسب SHARED معتبر است.
https://www.googleapis.com/auth/drive.labels.readonly مشاهده و استفاده از برچسب‌های درایو.
  • این دامنه اجازه دسترسی کاربر را می‌دهد و برای عملیات خواندن در صورت تنظیم نشدن use_admin_access مورد نیاز است.
https://www.googleapis.com/auth/drive.admin.labels مشاهده، ویرایش، ایجاد و حذف تمام برچسب‌های Drive در سازمان شما، و مشاهده سیاست‌های مدیریتی مرتبط با برچسب سازمان شما.
  • این دامنه اجازه دسترسی ادمین را می‌دهد و برای عملیات نوشتن هنگام تنظیم use_admin_access مورد نیاز است. این دامنه همچنین اجازه دسترسی خواندن را می‌دهد.
  • عملیات نوشتن با این دامنه برای برچسب‌هایی با نوع برچسب SHARED یا ADMIN معتبر است.
https://www.googleapis.com/auth/drive.admin.labels.readonly مشاهده همه برچسب‌های درایو و سیاست‌های مدیریتی مرتبط با برچسب در سازمان شما.
  • این دامنه اجازه دسترسی ادمین را می‌دهد و برای عملیات خواندن هنگام تنظیم use_admin_access مورد نیاز است.

دسترسی مدیر

برای مدیریت برچسب‌های ADMIN ، باید موارد زیر را مشخص کنید:

  • برای استفاده از اعتبارنامه‌های مدیر کاربر، useAdminAccess true است.
  • مدیران حساب کاربری با امتیاز مدیریت برچسب‌ها .

useAdminAccess

مدیران سیستم باید پارامتر useAdminAccess را برای فراخوانی امتیازات مدیریتی خود تنظیم کنند. تنظیم useAdminAccess امکان مشاهده و ویرایش هر برچسبی را که متعلق به مشتری است فراهم می‌کند. این شامل برچسب‌های ADMIN و SHARED نیز می‌شود.

وقتی useAdminAccess تنظیم نشده باشد، درخواست‌های نوشتن فقط برای برچسب‌هایی با label type SHARED و برای کاربرانی با نقش EDITOR مناسب برای این برچسب مجاز هستند.

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