REST Resource: sharedAlbums

Recurso: Album

Representação de um álbum no Google Fotos. Álbuns são contêineres para itens de mídia. Se um álbum tiver sido compartilhado pelo aplicativo, ele terá uma propriedade shareInfo extra.

Representação JSON
{
  "id": string,
  "title": string,
  "productUrl": string,
  "isWriteable": boolean,
  "shareInfo": {
    object (ShareInfo)
  },
  "mediaItemsCount": string,
  "coverPhotoBaseUrl": string,
  "coverPhotoMediaItemId": string
}
Campos
id

string

Identificador do álbum. Esse é um identificador permanente que pode ser usado entre as sessões para identificar esse álbum.

title

string

Nome do álbum exibido para o usuário na conta do Google Fotos. Essa string não deve ter mais de 500 caracteres.

productUrl

string

[Somente saída] URL do Google Fotos para o álbum. O usuário precisa fazer login na conta do Google Fotos para acessar esse link.

isWriteable

boolean

[Somente saída] Verdadeiro se você puder criar itens de mídia no álbum. Esse campo se baseia nos escopos concedidos e nas permissões do álbum. Se os escopos forem alterados ou as permissões do álbum forem alteradas, esse campo será atualizado.

shareInfo

object (ShareInfo)

[Somente saída] Informações relacionadas a álbuns compartilhados. Esse campo só será preenchido se o álbum for compartilhado e se o desenvolvedor tiver criado o álbum e o usuário tiver concedido o escopo photoslibrary.sharing.

mediaItemsCount

string (int64 format)

[Somente saída] O número de itens de mídia no álbum.

coverPhotoBaseUrl

string

[Somente saída] Um URL para os bytes da foto da capa. Não deve ser usado do jeito que está. Os parâmetros precisam ser anexados a esse URL antes do uso. Consulte a documentação do desenvolvedor para uma lista completa de parâmetros compatíveis. Por exemplo, '=w2048-h1024' define as dimensões da foto da capa para ter 2.048 px de largura e 1.024 px de altura.

coverPhotoMediaItemId

string

Identificador do item de mídia associado à foto da capa.

Métodos

get

Retorna o álbum com base no shareToken especificado.

join

Participa de um álbum compartilhado em nome do usuário do Google Fotos.

leave

Sai de um álbum compartilhado em nome do usuário do Google Fotos.

list

Lista todos os álbuns compartilhados disponíveis na guia "Compartilhar" do app Google Fotos do usuário.