Estás viendo la documentación heredada de la API de la biblioteca de Google Fotos.
Method: albums.patch
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Actualiza el álbum con el id especificado. Solo se leen los campos id, title y coverPhotoMediaItemId del álbum. El desarrollador debe haber creado el álbum a través de la API y debe ser propiedad del usuario.
Solicitud HTTP
PATCH https://photoslibrary.googleapis.com/v1/albums/{album.id}
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
album.id |
string
Es el identificador del álbum. Este es un identificador persistente que se puede usar entre sesiones para identificar este álbum.
|
Parámetros de consulta
| Parámetros |
updateMask |
string (FieldMask format)
Obligatorio. Indica qué campos del álbum proporcionado se deben actualizar. Los únicos valores válidos son title y coverPhotoMediaItemId. Esta es una lista separada por comas de los nombres de campos totalmente calificados. Ejemplo: "user.displayName,photo".
|
Cuerpo de la solicitud
El cuerpo de la solicitud contiene una instancia de Album.
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Album.
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata
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-07-25 (UTC)
[null,null,["Última actualización: 2025-07-25 (UTC)"],[[["\u003cp\u003eThis API updates an album with a specified ID, modifying only the title and cover photo, if provided in the request.\u003c/p\u003e\n"],["\u003cp\u003eThe album being updated must have been created by the developer via the API and be owned by the user.\u003c/p\u003e\n"],["\u003cp\u003eA \u003ccode\u003ePATCH\u003c/code\u003e request is used, targeting the album's ID in the URL.\u003c/p\u003e\n"],["\u003cp\u003eAn \u003ccode\u003eupdateMask\u003c/code\u003e query parameter is required to specify which album fields (title, coverPhotoMediaItemId) are being updated.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain an \u003ccode\u003eAlbum\u003c/code\u003e object with the updated fields, and the response, if successful, also contains an \u003ccode\u003eAlbum\u003c/code\u003e object.\u003c/p\u003e\n"]]],["This describes updating an album using a PATCH request to `https://photoslibrary.googleapis.com/v1/albums/{album.id}`. The `album.id` path parameter identifies the target album. The `updateMask` query parameter, with values `title` or `coverPhotoMediaItemId`, specifies which album fields to update. The request body contains the updated album information, while the successful response body returns the updated album. This operation requires the `https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata` authorization scope. Only albums created via the API and owned by the user can be modified.\n"],null,["# Method: albums.patch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdate the album with the specified `id`. Only the `id`, `title` and `coverPhotoMediaItemId` fields of the album are read. The album must have been created by the developer via the API and must be owned by the user.\n\n### HTTP request\n\n`PATCH https://photoslibrary.googleapis.com/v1/albums/{album.id}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|------------------------------------------------------------------------------------------------------------------------------|\n| `album.id` | `string` Identifier for the album. This is a persistent identifier that can be used between sessions to identify this album. |\n\n### Query parameters\n\n| Parameters ||\n|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updateMask` | `string (`[FieldMask](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask)` format)` Required. Indicate what fields in the provided album to update. The only valid values are `title` and `coverPhotoMediaItemId`. This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n\n### Request body\n\nThe request body contains an instance of [Album](/photos/library/legacy/reference/rest/v1/albums#Album).\n\n### Response body\n\nIf successful, the response body contains an instance of [Album](/photos/library/legacy/reference/rest/v1/albums#Album).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata`"]]
