REST Resource: sharedAlbums

Recurso: álbum

Representação de um álbum no Google Fotos. Os álbuns são contêineres de itens de mídia. Se um álbum tiver sido compartilhado pelo aplicativo, ele conterá 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 sessões para identificar este álbum.

title

string

Nome do álbum exibido para o usuário na conta do Google Fotos. Essa string não pode 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 for possível criar itens de mídia neste álbum. Este campo é baseado nos escopos concedidos e nas permissões do álbum. Se os escopos ou as permissões do álbum forem alterados, este campo será atualizado.

shareInfo

object (ShareInfo)

[Somente saída] Informações relacionadas aos álbuns compartilhados. Esse campo só será preenchido se o álbum for um álbum compartilhado, se o desenvolvedor criar o álbum e o usuário conceder 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] URL para os bytes da foto da capa. Este campo não deve ser usado como está. Os parâmetros devem ser anexados a este URL antes do uso. Consulte a documentação do desenvolvedor para ver uma lista completa dos parâmetros compatíveis. Por exemplo, '=w2048-h1024' define as dimensões da foto da capa para que tenham uma largura de 2048 px e altura de 1024 px.

coverPhotoMediaItemId

string

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

Métodos

get

Retorna o álbum com base no shareToken especificado.

join

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

leave

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

list

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