Photos Library API
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
عکس‌ها، ویدیوها و آلبوم‌های ایجاد شده توسط برنامه خود را در Google Photos مدیریت کنید
خدمات: photoslibrary.googleapis.com
نقطه پایان خدمات
نقطه پایانی سرویس یک URL پایه است که آدرس شبکه یک سرویس API را مشخص می کند. یک سرویس ممکن است چندین نقطه پایانی سرویس داشته باشد. این سرویس دارای نقطه پایانی سرویس زیر است و همه URI های زیر مربوط به این نقطه پایانی سرویس هستند:
-
https://photoslibrary.googleapis.com
| روش ها |
|---|
addEnrichment | POST /v1/albums/{albumId}:addEnrichment
غنی‌سازی را در یک موقعیت مشخص در آلبوم ایجاد شده توسط برنامه اضافه می‌کند. |
batchAddMediaItems | POST /v1/albums/{albumId}:batchAddMediaItems
یک یا چند مورد رسانه ایجاد شده از برنامه را در کتابخانه Google Photos کاربر به آلبوم ایجاد شده برنامه اضافه می کند. |
batchRemoveMediaItems | POST /v1/albums/{albumId}:batchRemoveMediaItems
یک یا چند مورد رسانه ایجاد شده برنامه را از آلبوم ایجاد شده برنامه مشخصی حذف می کند. |
create | POST /v1/albums
آلبومی را در کتابخانه Google Photos کاربر ایجاد می کند. |
get | GET /v1/albums/{albumId}
آلبوم ایجاد شده برنامه را بر اساس شناسه albumId مشخص شده برمی گرداند. |
list | GET /v1/albums
همه آلبوم های ایجاد شده توسط برنامه شما را فهرست می کند. |
patch | PATCH /v1/albums/{album.id}
آلبوم ایجاد شده برنامه را با id مشخص شده به روز کنید. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe Google Photos Library API allows you to manage photos, videos, and albums programmatically through REST resources.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides methods to interact with albums, including creating, adding enrichments, managing media items, and sharing (although sharing functionality will be deprecated on March 31, 2025).\u003c/p\u003e\n"],["\u003cp\u003eYou can also access and manipulate individual media items, such as retrieving details, updating properties, and performing searches.\u003c/p\u003e\n"],["\u003cp\u003eShared albums can be accessed, joined, and left, but these features are also scheduled for deprecation on March 31, 2025.\u003c/p\u003e\n"],["\u003cp\u003eAll interactions with the API are performed through the service endpoint \u003ccode\u003ehttps://photoslibrary.googleapis.com\u003c/code\u003e.\u003c/p\u003e\n"]]],["This API allows management of photos, videos, and albums in Google Photos via `photoslibrary.googleapis.com`. Key actions include creating, getting, listing, patching, adding, and removing media items within albums. It supports batch operations for media items and enrichment. Albums can be shared or unshared. Shared albums can be joined, left, retrieved, and listed. Several methods will no longer function after March 31, 2025 and other have some scope changes.\n"],null,["# Photos Library API\n\nManage photos, videos, and albums created by your app in Google Photos\n\n- [REST Resource: v1.albums](#v1.albums)\n- [REST Resource: v1.mediaItems](#v1.mediaItems)\n\nService: photoslibrary.googleapis.com\n-------------------------------------\n\n### Service endpoint\n\nA [service endpoint](https://cloud.google.com/apis/design/glossary#api_service_endpoint) is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:\n\n- `https://photoslibrary.googleapis.com`\n\nREST Resource: [v1.albums](/photos/library/reference/rest/v1/albums)\n--------------------------------------------------------------------\n\n| Methods ||\n|-----------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------|\n| [addEnrichment](/photos/library/reference/rest/v1/albums/addEnrichment) | `POST /v1/albums/{albumId}:addEnrichment` Adds an enrichment at a specified position in an app created created album. |\n| [batchAddMediaItems](/photos/library/reference/rest/v1/albums/batchAddMediaItems) | `POST /v1/albums/{albumId}:batchAddMediaItems` Adds one or more app created media items in a user's Google Photos library to an app created album. |\n| [batchRemoveMediaItems](/photos/library/reference/rest/v1/albums/batchRemoveMediaItems) | `POST /v1/albums/{albumId}:batchRemoveMediaItems` Removes one or more app created media items from a specified app created album. |\n| [create](/photos/library/reference/rest/v1/albums/create) | `POST /v1/albums` Creates an album in a user's Google Photos library. |\n| [get](/photos/library/reference/rest/v1/albums/get) | `GET /v1/albums/{albumId}` Returns the app created album based on the specified `albumId`. |\n| [list](/photos/library/reference/rest/v1/albums/list) | `GET /v1/albums` Lists all albums created by your app. |\n| [patch](/photos/library/reference/rest/v1/albums/patch) | `PATCH /v1/albums/{album.id}` Update the app created album with the specified `id`. |\n\nREST Resource: [v1.mediaItems](/photos/library/reference/rest/v1/mediaItems)\n----------------------------------------------------------------------------\n\n| Methods ||\n|-------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------|\n| [batchCreate](/photos/library/reference/rest/v1/mediaItems/batchCreate) | `POST /v1/mediaItems:batchCreate` Creates one or more media items in a user's Google Photos library. |\n| [batchGet](/photos/library/reference/rest/v1/mediaItems/batchGet) | `GET /v1/mediaItems:batchGet` Returns the list of app created media items for the specified media item identifiers. |\n| [get](/photos/library/reference/rest/v1/mediaItems/get) | `GET /v1/mediaItems/{mediaItemId}` Returns the app created media item for the specified media item identifier. |\n| [list](/photos/library/reference/rest/v1/mediaItems/list) | `GET /v1/mediaItems` List all media items created by your app from a user's Google Photos library. |\n| [patch](/photos/library/reference/rest/v1/mediaItems/patch) | `PATCH /v1/mediaItems/{mediaItem.id}` Update the app created media item with the specified `id`. |\n| [search](/photos/library/reference/rest/v1/mediaItems/search) | `POST /v1/mediaItems:search` Searches for app created media items in a user's Google Photos library. |"]]
