Estás viendo la documentación heredada de la API de la biblioteca de Google Fotos.
Descripción general de la API de Library
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Con la API de la Biblioteca de Google Fotos, tu app puede leer, escribir y compartir fotos y videos en Google Fotos.
La API de Library es una API de RESTful con carga útil de JSON. La estructura de la API se basa en los siguientes conceptos sobre el producto Google Fotos:
- Biblioteca: El contenido multimedia almacenado en la cuenta de Google Fotos del usuario
- Álbumes: Son colecciones de contenido multimedia que se pueden compartir con otros usuarios.
- Elementos multimedia: fotos, videos y sus metadatos
- Uso compartido: Función que permite a los usuarios compartir su contenido multimedia con otros usuarios.
Autorización
Al igual que otras APIs de REST de Google, la API de la Biblioteca usa OAuth 2.0 para controlar la autorización.
Tu app puede solicitar acceso a la biblioteca de Google Fotos del usuario a través de los diversos permisos de autorización que proporciona la API.
Ten en cuenta que la API de la Biblioteca no admite cuentas de servicio. Para usar esta API, los usuarios deben acceder a una Cuenta de Google válida.
Cómo usar la API de Library
Antes de comenzar a desarrollar tu app, ten en cuenta lo siguiente:
Explora la API
Para probar la API de Library sin escribir ningún código, usa el Explorador de API disponible en la documentación de referencia.
Estos son algunos métodos para intentar usar el Explorador de APIs:
Consulta nuestra muestra de código, que contiene algunas de las funciones clave de la API de la Biblioteca.
Programa de socios
Puedes integrar la API de la Biblioteca de Google Fotos sin unirte al Programa de socios.
Sin embargo, si es probable que tu app exceda el límite de cuota de disponibilidad general, expresa tu interés en el programa de socios de Google Fotos.
Más información
Estos son algunos lugares a los que puedes ir:
- Comenzar: Configura tu proyecto y
prueba la muestra.
- Guías: Las guías prácticas y los conceptos sobre el uso de la API de la Biblioteca.
- Referencia: la documentación de referencia de la API
- Asistencia: Son las opciones de asistencia para solicitar ayuda o enviar comentarios.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-29 (UTC)
[null,null,["Última actualización: 2025-08-29 (UTC)"],[[["\u003cp\u003eThe Google Photos Library API allows your app to read, write, and share photos and videos stored in Google Photos.\u003c/p\u003e\n"],["\u003cp\u003eIt uses a RESTful API with JSON payload and OAuth 2.0 for authorization, requiring users to be signed in to a Google Account.\u003c/p\u003e\n"],["\u003cp\u003eBefore developing your app, review the acceptable use policy, UX guidelines, and API limits and quotas.\u003c/p\u003e\n"],["\u003cp\u003eExplore the API through the API Explorer or by checking out the provided code samples.\u003c/p\u003e\n"],["\u003cp\u003eConsider joining the Google Photos partner program if your app is likely to exceed the general availability quota limit.\u003c/p\u003e\n"]]],["The Google Photos Library API enables apps to interact with Google Photos content, reading, writing, and sharing photos and videos. It's a RESTful API using JSON payloads, organized around libraries, albums, media items, and sharing. Access requires OAuth 2.0 authorization via specific scopes, and service accounts are not supported. Developers should adhere to usage policies, UX guidelines, and quotas. The API can be explored through the API Explorer, and code samples are available. Those who need more quota should apply to the Google Photos partner program.\n"],null,["# Library API overview\n\nUsing the Google Photos Library API your app can read, write, and share photos and videos in\nGoogle Photos.\n\nThe Library API is a [RESTful\nAPI](/photos/library/legacy/guides/about-restful-apis) with JSON payload. The structure\nof the API is based on the product concepts of Google Photos:\n\n- [Library](/photos/library/legacy/guides/list): media stored in the user's Google Photos account.\n- [Albums](/photos/library/legacy/guides/manage-albums): media collections which can be shared with other users.\n- [Media items](/photos/library/legacy/guides/access-media-items): photos, videos, and their metadata.\n- [Sharing](/photos/library/legacy/guides/share-media): feature that enables users to share their media with other users.\n\nAuthorization\n-------------\n\nLike other Google REST APIs, the Library API uses [OAuth\n2.0](/identity/protocols/OAuth2) to handle authorization.\nYour app can request access to the user's Google Photos library via the\nvarious [authorization\nscopes](/photos/library/legacy/guides/authorization) provided by the\nAPI.\n\nNote that the Library API does not support service accounts; to use this\nAPI, users must be signed in to a valid Google Account.\n\nUsing the Library API\n---------------------\n\nBefore you get started on your app development, keep the following in mind:\n\n- [Acceptable use policy](/photos/library/legacy/guides/acceptable-use)\n- [UX guidelines](/photos/library/legacy/guides/ux-guidelines) for designing your app\n- The Library API [limits and\n quotas](/photos/library/legacy/guides/api-limits-quotas)\n\nExplore the API\n---------------\n\nTo try out the Library API without writing any code, use the API Explorer\navailable in the reference documentation.\n\nHere are some methods to try using the API Explorer:\n\n- [List](/photos/library/legacy/reference/rest/v1/albums/list) your albums.\n- Apply filters to a [media item\n search](/photos/library/legacy/reference/rest/v1/mediaItems/search).\n\nCheck out our [code sample](/photos/library/samples) that shows some of the key\nfeatures of the Library API.\n\nPartner program\n---------------\n\nYou can integrate with the Google Photos Library API without joining the partner program.\nHowever, if your app is likely to exceed the general availability [quota\nlimit](/photos/library/legacy/guides/api-limits-quotas), express interest in the [Google Photos\npartner program](/photos/partner-program).\n\nLearn more\n----------\n\nSome places to go from here:\n\n- [Get started](/photos/library/legacy/guides/get-started): configure your project and try out the sample.\n- [Guides](/photos/library/legacy/guides/list): the how-to guides and concepts around using the Library API.\n- [Reference](/photos/library/reference): the API reference documentation\n- [Support](/photos/library/support/how-to-get-help): the support options for requesting help or giving feedback."]]
