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

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

OAuth 2.0 را برای مجوز پیکربندی کنید

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

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

برای تعریف سطح دسترسی اعطا شده به برنامه خود، باید محدوده های مجوز را شناسایی و اعلام کنید. محدوده مجوز یک رشته URI OAuth 2.0 است که حاوی نام برنامه Google Workspace، نوع داده‌هایی است که به آن دسترسی دارد و سطح دسترسی. Scopes درخواست‌های برنامه شما برای کار با داده‌های 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 مجاز برای برنامه را بخوانید و جستجو کنید.

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

محدوده برای برچسب ها

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

دامنه معنی
https://www.googleapis.com/auth/drive.labels برچسب‌های Drive را مشاهده، استفاده و مدیریت کنید.
  • این محدوده به کاربر اجازه دسترسی می دهد و برای عملیات نوشتن زمانی که use_admin_access تنظیم نشده باشد، لازم است.
  • عملیات نوشتن با این محدوده برای برچسب هایی با نوع برچسب SHARED معتبر است.
https://www.googleapis.com/auth/drive.labels.readonly مشاهده و استفاده از برچسب‌های Drive.
  • این محدوده به کاربر اجازه دسترسی می دهد و برای عملیات خواندن زمانی که 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 همه برچسب‌های Drive و خط‌مشی‌های مدیریت مرتبط با برچسب را در سازمان خود مشاهده کنید.
  • این محدوده امکان دسترسی ادمین را می‌دهد و برای عملیات خواندن زمانی که use_admin_access تنظیم شده است، لازم است.

دسترسی مدیر

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

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

useAdminAccess

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

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

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