REST Resource: albums

Recurso: Álbum

Representación de un álbum en Google Fotos. Los álbumes son contenedores de elementos multimedia. Si la aplicación compartió un álbum, este contiene una propiedad shareInfo adicional.

Representación JSON 
{
  "id": string,
  "title": string,
  "productUrl": string,
  "isWriteable": boolean,
  "shareInfo": {
    object (ShareInfo)
  },
  "mediaItemsCount": string,
  "coverPhotoBaseUrl": string,
  "coverPhotoMediaItemId": string
}
Campos
id

string

Es el identificador del álbum. Este es un identificador persistente que se puede usar entre sesiones para identificar este álbum.
title

string

Es el nombre del álbum que se muestra al usuario en su cuenta de Google Fotos. Esta cadena no debe tener más de 500 caracteres.
productUrl

string

[Solo salida] URL de Google Fotos del álbum. El usuario debe acceder a su cuenta de Google Fotos para acceder a este vínculo.
isWriteable

boolean

[Solo salida] Es verdadero si puedes crear elementos multimedia en este álbum. Este campo se basa en los permisos y los alcances otorgados al álbum. Si se cambian los permisos o los alcances del álbum, se actualiza este campo.
shareInfo

object (ShareInfo)

[Solo salida] Información relacionada con los álbumes compartidos. Este campo solo se completa si el álbum es compartido, el desarrollador lo creó y el usuario otorgó el permiso photoslibrary.sharing.
mediaItemsCount

string (int64 format)

[Solo salida] Es la cantidad de elementos multimedia del álbum.
coverPhotoBaseUrl

string

[Solo salida] Es una URL a los bytes de la foto de portada. No se debe usar tal como está. Se deben agregar parámetros a esta URL antes de usarla. Consulta la documentación para desarrolladores para obtener una lista completa de los parámetros admitidos. Por ejemplo, '=w2048-h1024' establece las dimensiones de la foto de portada para que tenga un ancho de 2,048 px y una altura de 1,024 px.
coverPhotoMediaItemId

string

Es el identificador del elemento multimedia asociado con la foto de portada.

ShareInfo

Información sobre los álbumes que se comparten Esta información solo se incluye si creaste el álbum, si está compartido y si tienes el permiso de uso compartido.

Representación JSON 
{
  "sharedAlbumOptions": {
    object (SharedAlbumOptions)
  },
  "shareableUrl": string,
  "shareToken": string,
  "isJoined": boolean,
  "isOwned": boolean,
  "isJoinable": boolean
}
Campos
sharedAlbumOptions

object (SharedAlbumOptions)

Son opciones que controlan si alguien puede agregar elementos multimedia a un álbum compartido o comentarlo.
shareableUrl

string

Un vínculo al álbum compartido de Google Fotos. Cualquier persona que tenga el vínculo puede ver el contenido del álbum, por lo que se debe usar con cuidado.

El parámetro shareableUrl solo se muestra si el álbum tiene activado el uso compartido de vínculos. Si un usuario ya se unió a un álbum que no se comparte con un vínculo, puede usar el productUrl del álbum para acceder a él.

Un shareableUrl se invalida si el propietario desactiva el uso compartido de vínculos en la app de Google Fotos o si se deja de compartir el álbum.
shareToken

string

Es un token que se usa para unirse a un álbum compartido, abandonarlo o recuperar sus detalles en nombre de un usuario que no es el propietario.

Un shareToken se invalida si el propietario desactiva el uso compartido de vínculos en la app de Google Fotos o si se deja de compartir el álbum.
isJoined

boolean

Es verdadero si el usuario se unió al álbum. Esto siempre es cierto para el propietario del álbum.
isOwned

boolean

Es verdadero si el usuario es el propietario del álbum.
isJoinable

boolean

Es verdadero si los usuarios pueden unirse al álbum.

SharedAlbumOptions

Son opciones que controlan el uso compartido de un álbum.

Representación JSON 
{
  "isCollaborative": boolean,
  "isCommentable": boolean
}
Campos
isCollaborative

boolean

Es verdadero si el álbum compartido permite que los colaboradores (usuarios que se unieron al álbum) le agreguen elementos multimedia. La configuración predeterminada es "false".
isCommentable

boolean

Es verdadero si el álbum compartido permite que los colaboradores (usuarios que se unieron al álbum) agreguen comentarios al álbum. La configuración predeterminada es "false".

Métodos

addEnrichment

 Agrega un enriquecimiento en una posición especificada en un álbum creado por una app.

batchAddMediaItems

 Agrega uno o más elementos multimedia creados por la app en la biblioteca de Google Fotos de un usuario a un álbum creado por la app.

batchRemoveMediaItems

 Quita uno o más elementos multimedia creados por la app de un álbum creado por la app especificado.

create

 Crea un álbum en la biblioteca de Google Fotos de un usuario.

get

 Muestra el álbum creado por la app según el albumId especificado.

list

 Muestra una lista de todos los álbumes creados por tu app.

patch

 Actualiza el álbum creado por la app con el id especificado.