با کتابخانه API شروع کنید

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

قبل از شروع

• نمای کلی را بررسی کنید: Picker API و Library API را با هم مقایسه کنید تا مطمئن شوید کتابخانه API مناسب مورد استفاده شما است.
• برنامه خود را پیکربندی کنید: API را فعال کنید و احراز هویت را تنظیم کنید. برای جزئیات مراحل، به پیکربندی برنامه خود مراجعه کنید.

موارد استفاده کلیدی کتابخانه API

کتابخانه API ایده آل برای سناریوهایی است که برنامه شما نیاز دارد:

• آپلود و ذخیره رسانه: عکس‌ها و ویدیوها (تولید شده توسط برنامه شما) را به صورت ایمن به کتابخانه‌های Google Photos کاربران خود وارد کنید.
• سازماندهی محتوا: آلبوم هایی ایجاد و مدیریت کنید تا به کاربران کمک کنید رسانه های مرتبط با برنامه خود را سازماندهی کنند.
• بهبود عکس‌ها و آلبوم‌ها: از طریق غنی‌سازی‌هایی مانند عنوان، توضیحات یا اطلاعات مکان، زمینه را به آیتم‌های رسانه و آلبوم‌ها اضافه کنید.
• دسترسی به داده‌های ایجادشده توسط برنامه: عکس‌ها، ویدیوها و آلبوم‌هایی را که برنامه شما قبلاً ایجاد کرده است، بازیابی کنید و با آنها تعامل داشته باشید.

گردش کار API کتابخانه معمولی

در حالی که کتابخانه API عملکردهای مختلفی را ارائه می دهد، یک گردش کار رایج ممکن است شامل این مراحل باشد:

1. آپلود رسانه: از نقطه پایانی آپلودها برای آپلود ایمن بایت های عکس یا ویدیو در Google Photos استفاده کنید. این مرحله یک uploadToken تولید می کند.

2. ایجاد آیتم های رسانه ای: از روش mediaItems.batchCreate ، با ارائه uploadToken ، برای ایجاد آیتم های رسانه در کتابخانه کاربر استفاده کنید.

3. ایجاد آلبوم (اختیاری): از روش albums.create برای ایجاد آلبوم در کتابخانه کاربر برای سازماندهی موارد رسانه استفاده کنید.

4. مدیریت آلبوم ها:

   • با استفاده از albums.batchAddMediaItems موارد رسانه (ایجاد شده توسط برنامه شما) را به آلبوم‌ها اضافه کنید.
   • با استفاده از albums.batchRemoveMediaItems موارد رسانه را از آلبوم ها حذف کنید.
   • با استفاده از albums.addEnrichment غنی‌سازی‌ها را به آلبوم‌ها (مانند عناوین یا مکان‌ها) اضافه کنید.
   • اطلاعات مربوط به آلبوم های خاص را با استفاده از albums.get بازیابی کنید.
   • آلبوم های ایجاد شده توسط برنامه شما را با استفاده از albums.list فهرست کنید.

5. دسترسی به رسانه های ایجاد شده توسط برنامه:

   • جزئیات مربوط به موارد رسانه خاص را با استفاده از mediaItems.get یا mediaItems.batchGet بازیابی کنید.
   • موارد رسانه ایجاد شده توسط برنامه خود را با استفاده از mediaItems.search جستجو کنید.
   • با استفاده از mediaItems.search با شناسه آلبوم، موارد رسانه را در یک آلبوم خاص ایجاد شده توسط برنامه فهرست کنید.

مراحل بعدی

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