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

El nombre del álbum que se muestra al usuario en su cuenta de Google Fotos Esta cadena no debe superar los 500 caracteres.

productUrl

string

[Solo salida] Es la 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 del álbum o los alcances, 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] La cantidad de elementos multimedia del álbum.

coverPhotoBaseUrl

string

[Solo salida] Una URL a los bytes de la foto de portada. No debes usarlo tal cual. Debes agregar los 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 tengan 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 tú creaste el álbum, este se comparte y tienes permiso para compartirlo.

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

object (SharedAlbumOptions)

Opciones que controlan si alguien puede agregar elementos multimedia a un álbum compartido o comentar un álbum compartido.

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 tratar 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 compartió mediante un vínculo, puede usar el productUrl del álbum para acceder a él.

Una shareableUrl se invalida si el propietario desactiva el uso compartido de vínculos en la app de Google Fotos o si el álbum no se comparte.

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.

Una shareToken se invalida si el propietario desactiva el uso compartido de vínculos en la app de Google Fotos o si el álbum no se comparte.

isJoined

boolean

Es verdadero si el usuario se unió al álbum. Esto siempre se aplica al propietario del álbum.

isOwned

boolean

Es verdadero si el usuario es propietario del álbum.

isJoinable

boolean

Es verdadero si otros usuarios pueden unirse al álbum.

SharedAlbumOptions

Opciones que controlan el uso compartido de un álbum.

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

boolean

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

isCommentable

boolean

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 de un álbum definido.

batchAddMediaItems

Agrega a un álbum uno o más elementos multimedia de la biblioteca de Google Fotos de un usuario.

batchRemoveMediaItems

Elimina uno o más elementos multimedia de un álbum específico.

create

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

get

Muestra el álbum en función del albumId especificado.

list

Enumera todos los álbumes que se muestran a un usuario en la pestaña Álbumes de la app de Google Fotos.

patch

Actualiza el álbum con el id especificado.

share

Marca un álbum como compartido y accesible para otros usuarios.

unshare

Marca un álbum compartido anteriormente como privado.