با Picker API شروع کنید

Picker API راهی امن برای کاربران شما فراهم می کند تا عکس ها و ویدیوها را از کتابخانه Google Photos خود انتخاب کرده و با برنامه شما به اشتراک بگذارند.

قبل از شروع

جریان Picker API

در اینجا یک نمای کلی از نحوه عملکرد Picker API آورده شده است:

  1. نشانه OAuth را بررسی کنید: قبل از شروع جریان Picker API، یک نشانه دسترسی معتبر OAuth 2.0 برای کاربر بررسی کنید. اگر نشانه ای وجود ندارد، جریان مجوز OAuth 2.0 را برای دریافت آن آغاز کنید .

  2. ایجاد یک جلسه: فرآیند را با برقراری تماس با Picker API برای ایجاد یک جلسه جدید آغاز کنید. این تماس یک pickerUri منحصر به فرد را برمی گرداند.

  3. کاربران را به برنامه Google Photos هدایت کنید: pickerUri را در اختیار کاربران خود قرار دهید (به عنوان یک پیوند قابل کلیک یا یک کد QR). این نشانی وب به‌طور ایمن برنامه Google Photos آنها را باز می‌کند.

  4. کاربر موارد رسانه ای را انتخاب می کند: در برنامه Google Photos، کاربران می توانند کتابخانه خود را مرور کنند و عکس ها و ویدیوهایی را که می خواهند با برنامه شما به اشتراک بگذارند انتخاب کنند. مروری بر تجربه انتخاب کاربر را بخوانید.

  5. نظرسنجی جلسه: برنامه شما باید به صورت دوره ای جلسه را نظرسنجی کند تا وضعیت را بررسی کند. شما به دنبال خاصیت mediaItemsSet هستید تا true را بازگرداند که نشان می دهد کاربر انتخاب خود را به پایان رسانده است.

  6. فهرست موارد رسانه انتخاب شده: هنگامی که mediaItemsSet true را برگرداند، می توانید از روش لیست برای دریافت جزئیات در مورد موارد رسانه انتخاب شده استفاده کنید.

  7. بازیابی و استفاده از آیتم های رسانه: اکنون به آیتم های رسانه انتخاب شده دسترسی دارید. می توانید محتوای آنها را با استفاده از baseUrl دریافت کنید و از آنها در برنامه خود استفاده کنید.

مراحل بعدی

  • اسناد مرجع را مرور کنید: مستندات مرجع Picker API را با جزئیات کاوش کنید تا در مورد همه روش‌ها و پارامترهای موجود بیاموزید.
  • نمونه ها را امتحان کنید: نمونه ما را بررسی کنید تا Picker API را در عمل ببینید و برای ادغام خود الهام بگیرید.