Photos Library API
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Gerenciar fotos, vídeos e álbuns criados pelo seu app no Google Fotos
Serviço: photoslibrary.googleapis.com
Endpoint de serviço
Um endpoint de serviço é um URL de base que especifica o endereço de rede de um serviço de API. Um serviço pode ter vários endpoints de serviço. Este serviço tem o endpoint a seguir e todos os URIs abaixo são relativos a ele:
https://photoslibrary.googleapis.com
| Métodos |
addEnrichment |
POST /v1/albums/{albumId}:addEnrichment
Adiciona um enriquecimento em uma posição especificada em um álbum criado por um app. |
batchAddMediaItems |
POST /v1/albums/{albumId}:batchAddMediaItems
Adiciona um ou mais itens de mídia criados pelo app na biblioteca do Google Fotos de um usuário a um álbum criado pelo app. |
batchRemoveMediaItems |
POST /v1/albums/{albumId}:batchRemoveMediaItems
Remove um ou mais itens de mídia criados por um app de um álbum criado por um app especificado. |
create |
POST /v1/albums
Cria um álbum na biblioteca do Google Fotos de um usuário. |
get |
GET /v1/albums/{albumId}
Retorna o álbum criado pelo app com base no albumId especificado. |
list |
GET /v1/albums
Lista todos os álbuns criados pelo seu app. |
patch |
PATCH /v1/albums/{album.id}
Atualiza o álbum criado pelo app com o id especificado. |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 2025-07-25 UTC."],[[["\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. |"]]
