این سند، Google Picker و API مربوط به Google Picker را معرفی میکند. همچنین به شما کمک میکند تا تصمیم بگیرید کدام رویکرد برای برنامه شما بهترین است.
ابزار انتخابگر گوگل (Google Picker) یک پنجرهی محاورهای «باز کردن فایل» (File Open) برای اطلاعات ذخیره شده در گوگل درایو ارائه میدهد. این روشی است که به کاربران اجازه میدهد عکسها، ویدیوها و اسناد را از حساب درایو خود انتخاب یا آپلود کنند، بدون اینکه از برنامه خارج شوند.
رابط برنامهنویسی کاربردی گوگل پیکِر (Google Picker API) رابط فنی مورد استفاده برای پیادهسازی گوگل پیکِر در برنامه شماست. با استفاده از رابط برنامهنویسی کاربردی گوگل پیکِر، شما یک رابط کاربری آشنا ایجاد میکنید که پیچیدگی احراز هویت و مرور فایل را مدیریت میکند و پس از انتخاب کاربر، فرادادههای خاص فایل (مانند شناسهها و URLها) را به برنامه شما برمیگرداند.
موارد استفاده کلیدی
ابزار انتخابگر گوگل (Google Picker) همهکاره است و میتواند برای گردشهای کاری مختلف برنامهها تنظیم شود:
- جایگزین آپلود فایل : کاربران میتوانند مستقیماً از طریق Google Picker فایلی را در Drive آپلود کنند.
- ابزارهای همکاری : به کاربران این امکان را میدهد که اسناد گوگل یا صفحات گوگل خاصی را به یک کار مدیریت پروژه یا رویداد تقویم مشترک پیوند دهند.
- پیوستهای دارایی : از Google Picker به عنوان راهی برای کاربران استفاده کنید تا اسناد پشتیبان را از Drive به گزارش هزینه یا تیکت پشتیبانی پیوست کنند.
مقایسه برنامههای وب در مقابل برنامههای دسکتاپ و موبایل
در حالی که عملکرد اصلی ثابت میماند، پیادهسازی API انتخابگر گوگل بسته به محل اجرای برنامه شما متفاوت است. جدول مقایسه زیر تفاوتهای فنی و عملکردی را هنگام پیادهسازی برای برنامههای وب در مقابل برنامههای دسکتاپ و موبایل فهرست میکند.
| ویژگی | برنامههای وب | برنامههای دسکتاپ و موبایل |
|---|---|---|
| فناوری اولیه | کتابخانه جاوا اسکریپت سمت کلاینت. | پارامترهای URL مربوط به OAuth 2.0 و ریدایرکتهای HTTP. |
| رندرینگ | با طرحبندی رابط کاربری موجود برنامه ادغام میشود. | در یک تب جدید از مرورگر پیشفرض سیستم کاربر باز میشود. دیگر نمیتوان آن را در یک وبویو تعبیهشده نمایش داد. |
| جریان تأیید | به یک توکن دسترسی خاص که از طریق setOAuthToken ارسال میشود، نیاز دارد. | با اضافه کردن trigger_onepick=true به درخواست OAuth فعال میشود. |
| روش پاسخ | فراخوانیهای مستقیم جاوا اسکریپت. | تغییر مسیر آدرسهای اینترنتی (URI) یا طرحهای URL سفارشی. |
| محدودهها | انعطافپذیر؛ میتواند drive.file ، drive.readonly و غیره استفاده کند. | سختگیرانه؛ فقط drive.file مجاز است و نمیتوان آن را با سایر حوزهها ترکیب کرد. |
| پیکربندی | از رابط کاربری روان PickerBuilder در جاوا اسکریپت استفاده میکند. | از پارامترهای رشته پرس و جو در URL مجوز استفاده میکند. |
توجه داشته باشید که برای استفاده از دامنه drive.file ، کاربر باید هنگام دسترسی به Google Picker وارد سیستم شود.
تفاوتهای استراتژیک کلیدی عبارتند از:
- برنامههای وب برای تعامل بالا و سفارشیسازی عمیق (مانند نمایشهای خاص بر اساس نوع فایل و محدود کردن نمایش به پوشههای خاص درایو) طراحی شدهاند.
- برنامههای دسکتاپ و موبایل برای امنیت و سادگی طراحی شدهاند و از مرورگر سیستم برای مدیریت احراز هویت و انتخاب فایل در یک جریان واحد و یکپارچه استفاده میکنند.
مباحث مرتبط
- ادغام Google Picker در برنامههای وب
- ادغام Google Picker در برنامههای دسکتاپ و موبایل
- انتخاب محدودههای API گوگل درایو