با کتابخانه API شروع کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
کتابخانه API به شما امکان می‌دهد با عکس‌ها، ویدیوها و آلبوم‌های موجود در کتابخانه‌های Google Photos کاربرانتان تعامل داشته باشید، اما با یک تمرکز مهم: فقط می‌توانید به محتوایی که توسط برنامه شما ایجاد شده است دسترسی داشته باشید و آن را مدیریت کنید.
قبل از شروع
موارد استفاده کلیدی کتابخانه API
کتابخانه API ایده آل برای سناریوهایی است که برنامه شما نیاز دارد:
- آپلود و ذخیره رسانه: عکس‌ها و ویدیوها (تولید شده توسط برنامه شما) را به صورت ایمن به کتابخانه‌های Google Photos کاربران خود وارد کنید.
- سازماندهی محتوا: آلبوم هایی ایجاد و مدیریت کنید تا به کاربران کمک کنید رسانه های مرتبط با برنامه خود را سازماندهی کنند.
- بهبود عکس‌ها و آلبوم‌ها: از طریق غنی‌سازی‌هایی مانند عنوان، توضیحات یا اطلاعات مکان، زمینه را به آیتم‌های رسانه و آلبوم‌ها اضافه کنید.
- دسترسی به داده‌های ایجادشده توسط برنامه: عکس‌ها، ویدیوها و آلبوم‌هایی را که برنامه شما قبلاً ایجاد کرده است، بازیابی کنید و با آنها تعامل داشته باشید.
گردش کار API کتابخانه معمولی
در حالی که کتابخانه API عملکردهای مختلفی را ارائه می دهد، یک گردش کار رایج ممکن است شامل این مراحل باشد:
آپلود رسانه: از نقطه پایانی آپلودها برای آپلود ایمن بایت های عکس یا ویدیو در Google Photos استفاده کنید. این مرحله یک uploadToken تولید می کند.
ایجاد آیتم های رسانه ای: از روش mediaItems.batchCreate ، با ارائه uploadToken ، برای ایجاد آیتم های رسانه در کتابخانه کاربر استفاده کنید.
ایجاد آلبوم (اختیاری): از روش albums.create برای ایجاد آلبوم در کتابخانه کاربر برای سازماندهی موارد رسانه استفاده کنید.
مدیریت آلبوم ها:
دسترسی به رسانه های ایجاد شده توسط برنامه:
- جزئیات مربوط به موارد رسانه خاص را با استفاده از
mediaItems.get یا mediaItems.batchGet بازیابی کنید. - موارد رسانه ایجاد شده توسط برنامه خود را با استفاده از
mediaItems.search جستجو کنید. - با استفاده از
mediaItems.search با شناسه آلبوم، موارد رسانه را در یک آلبوم خاص ایجاد شده توسط برنامه فهرست کنید.
مراحل بعدی
- اسناد مرجع را مرور کنید: مستندات مرجع کتابخانه API با جزئیات را کاوش کنید تا در مورد همه روش ها و پارامترهای موجود اطلاعات کسب کنید.
- نمونه ها را امتحان کنید: نمونه ما را بررسی کنید تا کتابخانه API را در عمل ببینید و برای ادغام خود الهام بگیرید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe Library API allows your application to interact with photos, videos, and albums in users' Google Photos libraries, but only for content created by your application.\u003c/p\u003e\n"],["\u003cp\u003eKey use cases include uploading/storing media, organizing content into albums, enhancing media with details, and accessing previously created app data.\u003c/p\u003e\n"],["\u003cp\u003eA typical workflow involves uploading media, creating media items, optionally creating and managing albums, and accessing the app-created media.\u003c/p\u003e\n"],["\u003cp\u003eBefore starting, ensure the Library API aligns with your needs by reviewing the overview and configuring your app for API access.\u003c/p\u003e\n"]]],["The Library API enables interaction with Google Photos, specifically for app-created content. Key actions include uploading media using an `uploadToken`, creating media items in the user's library, and optionally organizing them into albums. You can also manage albums by adding or removing media, adding enrichments, and retrieving album information. The API allows retrieval and searching of app-created media items. The first step before starting to use this API is to configure your application and ensure the Library API is suitable for your use case.\n"],null,["# Get started with the Library API\n\nThe Library API lets you to interact with photos, videos, and albums within your\nusers' Google Photos libraries, but with an important focus: you can only access\nand manage content that was created by your application.\n\nBefore you start\n----------------\n\n- **Check out the overview:** [Compare the Picker API and the Library API](/photos/overview/about) to make sure the Library API is the right fit for your use case.\n- **Configure Your app:** Enable the API and set up authentication. See [Configure your app](/photos/overview/configure-your-app) for detailed steps.\n\nKey use cases of the Library API\n--------------------------------\n\nThe Library API is ideal for scenarios where your app needs to:\n\n- **Upload and store media:** Securely import photos and videos (generated by your app) into your users' Google Photos libraries.\n- **Organize content:** Create and manage albums to help users organize their app-related media.\n- **Enhance photos and albums:** Add context to media items and albums through enrichments like titles, descriptions, or location information.\n- **Access app-created data:** Retrieve and interact with the photos, videos, and albums that your app has previously created.\n\nTypical Library API workflow\n----------------------------\n\nWhile the Library API offers various functionalities, a common workflow might\ninvolve these steps:\n\n1. **Upload media:** Use the [uploads endpoint](/photos/library/guides/upload-media)\n to securely upload photo or video bytes to Google Photos. This step\n generates an\n [`uploadToken`](/photos/library/reference/rest/v1/mediaItems/batchCreate#SimpleMediaItem.FIELDS.upload_token).\n\n2. **Create media items:** Use the [`mediaItems.batchCreate`\n method](/photos/library/guides/upload-media#creating-media-item), providing\n the `uploadToken`, to create media items in the user's library.\n\n3. **Create albums (optional):** Use the [`albums.create` method](/photos/library/guides/manage-albums#creating-new-album)\n to create albums within the user's library to organize the media items.\n\n4. **Manage albums:**\n\n - Add media items (created by your app) to albums using [`albums.batchAddMediaItems`.](/photos/library/guides/manage-albums#adding-items-to-album)\n - Remove media items from albums using [`albums.batchRemoveMediaItems`](/photos/library/guides/manage-albums#removing-items-from-album).\n - Add enrichments to albums (like titles or locations) using [`albums.addEnrichment`.](/photos/library/guides/add-enrichments#intro-adding-enrichments-album)\n - Retrieve information about specific albums using [`albums.get`](/photos/library/guides/list#listing-albums).\n - List albums created by your app using [`albums.list`](/photos/library/guides/list#listing-albums).\n5. **Access app-created media:**\n\n - Retrieve details about specific media items using `mediaItems.get` or `mediaItems.batchGet`.\n - Search for media items created by your app using `mediaItems.search`.\n - List media items within a specific app-created album using `mediaItems.search` with the album ID.\n\nNext steps\n----------\n\n- Review the reference docs: Explore the detailed [Library API reference\n documentation](/photos/library/reference/rest) to learn about all the available methods and parameters.\n- Try out the samples: Check out our [sample](/photos/library/samples) to see the Library API in action and get inspiration for your integration."]]
